Share via

CeSetUserNotificationEx

  • Article

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

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

Parameters

  • 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.

Return Values

Returns a handle to the notification event if successful. Returns NULL if unsuccessful.

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.

Requirements

OS Versions: Windows CE 2.12 and later.
Header: Notify.h.
Link Library: Coredll.lib.

See Also

CE_USER_NOTIFICATION | CE_NOTIFICATION_TRIGGER | IOCTL_KLIB_GETALARMRESOLUTION | Notify Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.