CE_NOTIFICATION_TRIGGER
A version of this page is also available for
4/8/2010
This structure defines what event activates a notification.
Syntax
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 CeSetUserNotificationEx 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. To be signaled by the event, an application must call CreateEvent and then one of the "WaitFor" synchronization functions (WaitForMultipleObjects or WaitForSingleObject). For more information, see Synchronization Functions. Named events are supported in Windows Embedded 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
| Header | notify.h |
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
CeSetUserNotificationEx
Notify Structures