WM_ADSPROP_SHEET_CREATE message

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, 
                     (UINT)   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.

lParam

Not used. Must be NULL.

Return value

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

Requirement Value
Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008

See also

CFSTR_DS_PARENTHWND

DSA_SEC_PAGE_INFO

DSOBJECTNAMES

DSOBJECT

LocalAlloc

LocalFree