Share via


CE_NOTIFICATION_TRIGGER (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

Notify Structures
CeSetUserNotificationEx

Other Resources

CreateEvent
SetEvent
SYSTEMTIME