CE_NOTIFICATION_TRIGGER

This structure defines what event activates a notification.

typedef struct UserNotificationTrigger {
  DWORD dwSize;
  DWORD dwType;
  DWORD dwEvent;
  WCHAR* lpszApplication;
  WCHAR* lpszArguments;
  SYSTEMTIME stStartTime;
  SYSTEMTIME stEndTime;
} CE_NOTIFICATION_TRIGGER, *PCE_NOTIFICATION_TRIGGER;

Members

• dwSize
  DWORD that specifies the size of this structure in bytes.

• dwType
  DWORD that specifies the type of notification. The following table shows the possible values.

  Value	Description
  CNT_EVENT	System event notification.
  CNT_TIME	Time-based notification.
  CNT_PERIOD	Time-based notification that is active for the time period between stStartTime and stEndTime.
  CNT_CLASSICTIME	Equivalent to using the CeSetUserNotification function. The standard command line is supplied.

• dwEvent
  DWORD that specifies the type of event if dwType is CNT_EVENT. The following table shows the possible values.

  Value	Description
  NOTIFICATION_EVENT_DEVICE_CHANGE	A PC Card device changed.
  NOTIFICATION_EVENT_IR_DISCOVERED	The device discovered a server by using infrared communications.
  NOTIFICATION_EVENT_NET_CONNECT	The device connected to a network.
  NOTIFICATION_EVENT_NET_DISCONNECT	The device disconnected from a network.
  NOTIFICATION_EVENT_NONE	No events occurred. Remove all event registrations for this application.
  NOTIFICATION_EVENT_OFF_AC_POWER	The user turned the alternating current (AC) power off.
  NOTIFICATION_EVENT_ON_AC_POWER	The user turned the AC power on.
  NOTIFICATION_EVENT_RESTORE_END	A full device data restore completed.
  NOTIFICATION_EVENT_RS232_DETECTED	An RS232 connection was made.
  NOTIFICATION_EVENT_SYNC_END	Data synchronization finished.
  NOTIFICATION_EVENT_TIME_CHANGE	The system time changed.
  NOTIFICATION_EVENT_TZ_CHANGE	The time zone changed.
  NOTIFICATION_EVENT_WAKEUP	The device woke up.

• lpszApplication
  Pointer to a null-terminated string that contains the name of the application to execute. You can also use this string to support a named event instead of launching an application. The following code example shows the format that you should use for the string pointed to by lpszApplication when you want to use lpszApplication to support a named event instead of launching an application.

  "\\\\.\\Notifications\\NamedEvents\\Event Name"
  

  Event Name represents the application-defined name of the event to signal. When you use this format for lpszApplication, the event is opened and signaled. Named events are supported in Microsoft® Windows® CE .NET.

• lpszArguments
  Pointer to a null-terminated string that contains the arguments for the command line used to execute the application. This string does not include the application name.

• stStartTime
  SYSTEMTIME structure that specifies the beginning of the notification period.

• stEndTime
  SYSTEMTIME structure that specifies the end of the notification period.

Remarks

The new event based trigger enables an application to create a named event by calling the CreateEvent function and then requesting that the notification subsystem set the named event when the notification event occurs. The application can use either a manual or reset event depending on the desired behavior. By default, the notification subsystem only calls the SetEvent function to trigger the event.

Requirements

OS Versions: Windows CE 2.12 and later.
Header: Notify.h.

See Also

CeSetUserNotification | CreateEvent | SetEvent | SYSTEMTIME | Notify Structures

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.