Directory Services

WM_ADSPROP_SHEET_CREATE

The WM_ADSPROP_SHEET_CREATE message is sent to the notification object to create a secondary property sheet in an Active Directory MMC snap-in.

Note  This message value is not defined in a published header file. To use this message value, you must define it yourself in the exact format shown.

#define WM_ADSPROP_SHEET_CREATE (WM_USER + 1108)

LRESULT SendMessage(
	(HWND) hwnd, 
	WM_ADSPROP_SHEET_CREATE,
	(WPARAM) wParam, 
	(LPARAM) lParam);

Parameters

hwnd
The handle of the notification object. To obtain this handle, call ADsPropCreateNotifyObj.
wParam
Contains a pointer to a DSA_SEC_PAGE_INFO structure that defines the secondary page to create. Only one secondary property sheet can be created with the WM_ADSPROP_SHEET_CREATE message, so the DSOBJECTNAMES structure can only contain one DSOBJECT structure.

Note  For Windows 2000, this parameter contains a pointer to a DSA_SEC_PAGE_INFO_WIN2K structure instead of a DSA_SEC_PAGE_INFO structure.

lParam
Not used. Must be NULL.

Return Values

The return value for this message is always zero.

Remarks

The caller must allocate the DSA_SEC_PAGE_INFO structure, the title string and all DSOBJECT strings using a single call to the LocalAlloc function. The WM_ADSPROP_SHEET_CREATE message is an asynchronous message, so it will return before the secondary sheet is created. Because of this, the memory must remain intact after the message returns. The receiver will free this memory with a single call to the LocalFree function after the secondary sheet is created.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.

See Also

CFSTR_DS_PARENTHWND, DSA_SEC_PAGE_INFO, DSA_SEC_PAGE_INFO_WIN2K, DSOBJECTNAMES, DSOBJECT, LocalAlloc, LocalFree