CE_USER_NOTIFICATION (Windows CE 5.0)

  • Article

Send Feedback

This structure contains information used to initialize the user notifications settings dialog box, and receives the user's notification preferences entered by way of the dialog box. Also used when setting a user notification.

typedef struct UserNotificationType {DWORD ActionFlags;TCHAR* pwszDialogTitle;TCHAR* pwszDialogText;TCHAR* pwszSound;DWORD nMaxSound;DWORD dwReserved;} CE_USER_NOTIFICATION, *PCE_USER_NOTIFICATION;

Members

  • ActionFlags
    DWORD that specifies the action to take when a notification event occurs. The following table shows the possible values.

    Value Description
    PUN_LED Flashes the LED.
    PUN_VIBRATE Vibrates the device.
    PUN_DIALOG Displays the user notification dialog box. When this structure is passed to the CeSetUserNotification function, the pwszDialogTitle and pwszDialogText members must provide the title and text of the dialog box.
    PUN_SOUND Plays the sound specified by the pwszSound member. When passed to PSVN, the pwszSound member must provide the name of the sound file.
    PUN_REPEAT Repeats the pwszSound for 10–15 seconds. Only valid if PUN_SOUND is set.

    Any flag that is not valid on the current hardware platform is ignored.

  • pwszDialogTitle
    Pointer to the string that contains the title of the user notification dialog box. If this member is NULL, no dialog is displayed. The CeGetUserNotificationPreferences function ignores this member.

  • pwszDialogText
    Pointer to the string that contains the text of the user notification dialog box. If this member is NULL, no dialog is displayed. The CeGetUserNotificationPreferences function ignores this member.

  • pwszSound
    Pointer to a buffer that contains the unqualified name of a sound file to play. This member is ignored if the ActionFlags member does not include the PUN_SOUND flag.

  • nMaxSound
    DWORD that specifies the maximum length of the string that the CeGetUserNotificationPreferences function can copy into the pwszSound buffer. Because the string may be a path name in a future release, the buffer must be at least the length derived by the following expression: MAX_PATH * sizeof(TCHAR). This member is ignored by the CeSetUserNotification function.

  • dwReserved
    Reserved; set to zero.

Remarks

The CE_USER_NOTIFICATION structure is passed in the CeGetUserNotificationPreferences function. Initial settings are used to populate the dialog box. If the function returns TRUE, the returned settings should be saved, and considered when calling CeSetUserNotification. Settings for hardware not on the current device will be ignored.

It is also used when calling CeSetUserNotification, to describe what should happen when the notification time is reached.

Windows Mobile Remarks

The ActionFlags value PUN_LED is not supported on a Windows Mobile-based Smartphone.

Setting the ActionFlags value PUN_DIALOG on a Windows Mobile-based Pocket PC will cause sounds to be played based on the user settings in the Sounds and Notifications Control Panel Application (CPL). In addition, sounds that result from other ActionFlags flags being set are also played. This will result in multiple sounds on the Windows Mobile-based Pocket PC. To avoid multiple sounds, you should not set any other ActionFlags flags on a Windows Mobile-based Pocket PC except PUN_DIALOG.

Requirements

OS Versions: Windows CE 1.01 and later.
Header: Notify.h.

See Also

CeGetUserNotificationPreferences | CeSetUserNotification | Notify Structures

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.