Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This 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 
);

Parameters

hWndParent

[in] Handle to the parent window for the notification settings dialog box.

lpNotification

[in, out] Long pointer to a CE_USER_NOTIFICATIONstructure. 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 Value

TRUE indicates success. FALSE indicates failure or that the user did not change the settings.

Remarks

If the function returns TRUE, the settings returned in the CE_USER_NOTIFICATIONstructure should be saved and considered when calling CeSetUserNotificationEx.

Requirements

Header notify.h
Library coredll.lib
Windows Embedded CE Windows CE 1.01 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also