Directory Services

IDsAdminNewObjPrimarySite::Commit

The IDsAdminNewObjPrimarySite::Commit method causes a single-page primary object creation extension's IDsAdminNewObjExt::WriteData method to be called and writes the temporary Active Directory® object to persistent memory.

HRESULT Commit();

Parameters

This method has no parameters.

Return Values

Returns S_OK if successful or an OLE-defined error code otherwise. This method fails if the calling extension is not a primary object creation extension. This method also fails if the object creation wizard contains more than one page.

Remarks

The IDsAdminNewObjPrimarySite::CreateNew method must be called before IDsAdminNewObjPrimarySite::Commit is called.

When an object creation wizard contains more than one page, the system implements a "Finish" page that displays a summary of the object data to be saved. The system-implemented "Finish" page will perform the IDsAdminNewObjPrimarySite::Commit operation. If, however, the object creation wizard only contains one page, the page will have OK and Cancel command buttons instead of the Back, Next and Cancel buttons normally found in a wizard and no "Finish" page is provided. Because of this, a single-page object creation extension wizard must call Commit.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Dsadmin.h.

See Also

IDsAdminNewObjPrimarySite, IDsAdminNewObjExt::WriteData, IDsAdminNewObjPrimarySite::CreateNew