Platform SDK: Active Directory, ADSI, and Directory Services

IDsAdminNewObjPrimarySite

The IDsAdminNewObjPrimarySite interface allows a primary wizard extension to create a new temporary ADSI object and then commit that object to Active Directory™.

When to Implement

Applications do not implement the IDsAdminNewObjPrimarySite interface. The system implements a COM object that supports this interface and can be retrieved through IDsAdminNewObj::QueryInterface, which is supplied through IDsAdminNewObjExt::Initialize.

When to Use

Use the IDsAdminNewObjPrimarySite interface if you are implementing a primary wizard extension using IDsAdminNewObjExt. The IDsAdminNewObjPrimarySite interface allows you to create a temporary object using CreateNew. Then, attributes of that object are filled as the wizard progresses. Next, the object is written to Active Directory using Commit.

Methods in Vtable Order

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

IDsAdminNewObjPrimarySite Methods

Method Description
CreateNew Creates a temporary Active Directory object with a given name in the ADSI cache.
Commit Writes the temporary object, from the ADSI cache, to Active Directory.

Requirements

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

See Also

Active Directory Admin Interfaces, IDsAdminCreateObj, IDsAdminNewObj, IDsAdminNewObjExt, IDsAdminNewObjExt::Initialize