Directory Services


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


[in] The handle of the notification object. To obtain this handle, call ADsPropCreateNotifyObj.
[in] A window handle of the property page.
[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.


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.


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