CeSetUserNotificationEx (Compact 2013)

3/28/2014

This function creates a new user notification or modifies an existing one.


HANDLE CeSetUserNotificationEx(
  HANDLE hNotification, 
  CE_NOTIFICATION_TRIGGER* pcnt, 
  CE_USER_NOTIFICATION* pceun 
);

hNotification

[in] Handle to the notification to overwrite or 0 to add a new notification.

pcnt

[in] Pointer to a CE_NOTIFICATION_TRIGGER structure that defines what event activates a notification.

pceun

[in] Pointer to the CE_USER_NOTIFICATION structure that defines how the system should respond when a notification occurs. For example, the system could launch a dialog box or another application.

Returns a handle to the notification object if successful. This handle can then be used with the other Notify functions. Returns NULL if unsuccessful.

Notifications which are time-bound will be deleted once the time passes. For event-based notifications, the notification won't disappear after the event is triggered. The user has to manually delete the notification using CeClearUserNotification.

If the scheduled time lies within the platform-dependent period defined by the accuracy of the real-time clock (RTC), the notification may be scheduled immediately. The accuracy may be retrieved by IOCTL_KLIB_GETALARMRESOLUTION and may range from 1 to 60 seconds. If the platform does not implement IOCTL_KLIB_GETALARMRESOLUTION, the default RTC accuracy of 10 seconds is assumed.

If pcnt->dwType is set to CNT_EVENT, the pceun parameter should be set to NULL. Otherwise the function call will fail and return ERROR_INVALID_PARAMETER.

To delete a notification and release the handle, use the handle returned by CeSetUserNotificationEx in a call to CeClearUserNotification. To overwrite a notification, use the returned handle in another call to CeSetUserNotificationEx.

Header

notify.h

Library

coredll.lib

Show: