Platform SDK: Active Directory, ADSI, and Directory Services

IDsAdminCreateObj

The IDsAdminCreateObj interface enables an application the use of the creation wizard for a specified class in order to create a new object of that class.

When to Implement

Applications do not implement the IDsAdminCreateObj interface. The system implements a COM object that supports this interface.

When to Use

The IDsAdminCreateObj is used to invoke the object creation wizard. The wizard enables a user to create objects in an Active Directory™ container, such as an OU - Organizational Unit. To create an instance of the system's IDsAdminCreateObj implementation, call the CoCreateInstance function as shown in the following sample code.

HRESULT hr = S_OK;
IDsAdminCreateObj* pCreateObj = NULL;
hr = ::CoCreateInstance(CLSID_DsAdminCreateObj,
        NULL, CLSCTX_INPROC_SERVER,
        IID_IDsAdminCreateObj,
        (void**)&pCreateObj);

Methods in Vtable Order

IUnknown Methods Description
QueryInterface Returns pointers to supported interfaces.
AddRef Increments reference count.
Release Decrements reference count.

IDsAdminCreateObj Methods

Method Description
Initialize Initializes the interface with information about the container where the object will be created, the class of the object to be created and, possibly, the copy source.
CreateModal Displays the creation wizard and returns a newly created object.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Dsadmin.h.

See Also

Active Directory Admin Interfaces, CoCreateInstance, IDsAdminNewObj, IDsAdminNewObjPrimarySite, IDsAdminNewObjExt