IDsAdminCreateObj::CreateModal method

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(
  HWND hwndParent,
  IADs **ppADsObj
);

Parameters

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.

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

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header dsadmin.h
DLL DSAdmin.dll

See Also

GetDesktopWindow

IADs

IDsAdminCreateObj

IDsAdminCreateObj::Initialize

SUCCEEDED