CE_NOTIFICATION_TRIGGER (Windows CE 5.0)
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_INTERNET_PROXY_CHANGE The Internet Proxy used by the device has 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_RNDIS_FN_DETECTED RNDISFN interface is instantiated. 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.
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
Send Feedback on this topic to the authors