Directory Services

ADsPropSetHwndWithTitle

The ADsPropSetHwndWithTitle function is used to notify the notification object of the property page window handle. This function includes the title of the property page which enables the error dialog displayed by ADsPropShowErrorDialog to provide more useful information to the user.

BOOL ADsPropSetHwndWithTitle(
  HWND hNotifyObject,
  HWND hPage,
  PTSTR ptzTitle
);

Parameters

hNotifyObject
[in] The handle of the notification object. To obtain this handle, call ADsPropCreateNotifyObj.
hPage
[in] A window handle of the property page.
ptzTitle
[in] Pointer to a NULL-terminated string that contains the property page title.

Return Values

Returns zero if the notification object does not exist or non-zero otherwise.

Remarks

An Active Directory property sheet extension normally calls this function while processing the WM_INITDIALOG message.

If the property sheet extension uses the ADsPropShowErrorDialog function, the extension should use ADsPropSetHwndWithTitle rather than ADsPropSetHwnd.

Requirements

Client: Included in Windows XP.
Server: Included in Windows Server 2003.
Unicode: Implemented as Unicode and ANSI versions.
Header: Declared in Adsprop.h.
Library: Use DsProp.lib.

See Also

ADsPropCreateNotifyObj, WM_INITDIALOG, ADsPropSetHwnd, ADsPropShowErrorDialog