IDsAdminCreateObj::CreateModal method (dsadmin.h)
The IDsAdminCreateObj::CreateModal method displays the object creation wizard and returns the newly created object. The IDsAdminCreateObj::Initialize method must be called before IDsAdminCreateObj::CreateModal can be called.
Syntax
HRESULT CreateModal(
[in] HWND hwndParent,
[out] IADs **ppADsObj
);
Parameters
[in] hwndParent
Contains the window handle of the owner of the wizard. This value cannot be NULL. Use the result of the GetDesktopWindow function if no parent window is available.
[out] ppADsObj
Pointer to an IADs interface pointer that receives the newly created object. This parameter receives NULL if the object creation wizard fails or is canceled. The caller must release this interface when it is no longer required. This parameter may be NULL if this object is not required.
Return value
This method can return one of these values.
Returns an OLE-defined error code or one of the following values.
Remarks
If the user cancels the object creation wizard, this method returns S_FALSE. If ppADsObj is not NULL, ppADsObj receives a NULL value. Because of this, the use of the SUCCEEDED macro to determine if ppADsObj is valid should be avoided. Always test the contents of ppADsObj for a non-NULL value before using the interface pointer.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | dsadmin.h |
| DLL | DSAdmin.dll |