CeGetUserNotificationPreferences

The CeGetUserNotificationPreferences function queries the user for notification settings by displaying a dialog box showing options that are valid for the current hardware platform.

Syntax

BOOL CeGetUserNotificationPreferences(HWND hWndParent, PCE_USER_NOTIFICATION lpNotification);

At a Glance

Header file: Notify.h
Platforms: H/PC
Versions: 1.01 and later

Parameters

hWndParent
Handle to the parent window for the notification settings dialog box.
lpNotification
Pointer to a CE_USER_NOTIFICATION structure. When calling CeGetUserNotificationPreferences, this structure contains data used to initialize the notification settings dialog box. When the function returns, this structure contains the user's notification settings.

Return Values

If the function succeeds, the return value is TRUE. If the function returns TRUE, the returned settings should be saved and considered when calling CeSetUserNotification.

If the function fails or the user does not change the settings, the return value is FALSE.

Remarks

When writing applications for Windows CE version 1.0, use the function PegGetUserNotificationPreferences.

See Also

CeSetUserNotification, CE_USER_NOTIFICATION