CE_NOTIFICATION_TRIGGER (Compact 2013)
3/28/2014
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.
CNT_SYSTEMTIME
Time-based notification that uses SYSTEMTIME instead of local time.
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 device changed.
NOTIFICATION_EVENT_INTERNET_PROXY_CHANGE
The Internet Proxy used by the device has changed.
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 Compact.
- 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 in local time.
- stEndTime
SYSTEMTIME structure that specifies the end of the notification period in local time.
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 |
See Also
Reference
Notify Structures
CeSetUserNotificationEx