IDsAdminNewObjExt::Initialize-Methode (dsadmin.h)

Artikel
08/23/2023

Die IDsAdminNewObjExt::Initialize-Methode initialisiert eine Erweiterung des Assistenten für die Objekterstellung.

Syntax

HRESULT Initialize(
  [in] IADsContainer         *pADsContainerObj,
  [in] IADs                  *pADsCopySource,
  [in] LPCWSTR               lpszClassName,
  [in] IDsAdminNewObj        *pDsAdminNewObj,
  [in] LPDSA_NEWOBJ_DISPINFO pDispInfo
);

Parameter

[in] pADsContainerObj

Zeiger auf die IADsContainer-Schnittstelle eines vorhandenen Containers, in dem das Objekt erstellt wird. Dieser Parameter darf nicht NULL sein. Wenn dieses Objekt außerhalb des Bereichs dieser Methode beibehalten werden soll, muss die Verweisanzahl durch Aufrufen von IUnknown::AddRef oder IUnknown::QueryInterface erhöht werden.

[in] pADsCopySource

Zeiger auf die IADs-Schnittstelle des Objekts, aus dem eine Kopie erstellt wird. Wenn das neue Objekt nicht aus einem anderen Objekt kopiert wird, ist dieser Parameter NULL. Weitere Informationen zu Kopiervorgängen finden Sie im Abschnitt Hinweise. Wenn dieses Objekt außerhalb des Bereichs dieser Methode beibehalten werden soll, muss die Verweisanzahl durch Aufrufen von IUnknown::AddRef oder IUnknown::QueryInterface erhöht werden.

[in] lpszClassName

Zeiger auf eine WCHAR-Zeichenfolge , die den LDAP-Namen der zu erstellenden Objektklasse enthält. Dieser Parameter darf nicht NULL sein. Unterstützte Werte sind: "user", "computer", "printQueue", "group" und "contact".

[in] pDsAdminNewObj

Zeiger auf eine IDsAdminNewObj-Schnittstelle , die zusätzliche Daten zum Assistenten enthält. Sie können auch die IDsAdminNewObjPrimarySite-Schnittstelle der primären Erweiterung abrufen, indem Sie QueryInterface mit IID_IDsAdminNewObjPrimarySite auf dieser Schnittstelle aufrufen. Wenn dieses Objekt außerhalb des Bereichs dieser Methode beibehalten werden soll, muss die Verweisanzahl durch Aufrufen von IUnknown::AddRef oder IUnknown::QueryInterface erhöht werden.

[in] pDispInfo

Zeiger auf eine DSA_NEWOBJ_DISPINFO-Struktur , die zusätzliche Daten zum Objekterstellungs-Assistenten enthält.

Rückgabewert

Gibt S_OK zurück, wenn erfolgreich oder andernfalls ein OLE-definierter Fehlercode.

Hinweise

Ein Objekt in Active Directory Domain Services kann entweder aus dem Nichts erstellt oder aus einem vorhandenen Objekt kopiert werden. Wenn das neue Objekt aus einem vorhandenen Objekt erstellt wird, enthält pADsCopySource einen Zeiger auf das Objekt, aus dem die Kopie erstellt wird. Wenn das neue Objekt nicht aus einem anderen Objekt kopiert wird, ist pADsCopySourceNULL. Der Kopiervorgang wird nur für Benutzerobjekte unterstützt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	dsadmin.h
DLL	DSAdmin.dll