IDsAdminCreateObj::CreateModal method (dsadmin.h)

Article
02/22/2024

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