Assistenten zum Erstellen von Objekten

In den administrativen MMC-Snap-Ins von Active Directory Domain Services kann der Benutzer neue Objekte in einem Verzeichnis erstellen, indem das Kontextmenü für den Container geöffnet wird, in dem das neue Objekt erstellt wird, das neue Objekt erstellt wird, und die Klasse des zu erstellenden Objekts auswählen. Das Erstellen neuer Instanzen eines Objekts startet den Objekterstellungs-Assistenten. Jede Objektklasse kann die Verwendung eines bestimmten Erstellungs-Assistenten angeben oder einen generischen Erstellungs-Assistenten verwenden. Für allgemeine Klassen, z. B. Benutzer- und Organisationseinheit, stellt das Active Directory-Benutzer und -Computer-Snap-In einen Standardsatz von Erstellungs-Assistenten bereit.

Es gibt zwei Möglichkeiten zum Erweitern eines Erstellungs-Assistenten:

  • Ersetzen Sie einen vorhandenen Assistenten, oder geben Sie einen an, wenn eine nicht für die Klasse vorhanden ist: Der vorhandene Assistent wird durch das Erstellen einer primären Objekterstellungserweiterung ersetzt. Eine primäre Erstellungserweiterung stellt die erste Gruppe von Seiten bereit und wird auf dieselbe Weise wie native Seiten gehostet. Eine primäre Erstellungserweiterung unterstützt auch den Erweiterungsmechanismus, sodass andere Erstellungs-Assistentenerweiterungen aufgerufen werden können. Ein Beispiel für eine primäre Erweiterung finden Sie im Scpwizard-Beispiel im Platform Software Development Kit (SDK).
  • Erweitern eines vorhandenen Assistenten: Ein vorhandener Assistent kann mit einer sekundären Objekterstellungserweiterung erweitert werden. Eine sekundäre Erstellungserweiterung fügt Assistentenseiten zu den nativen Seiten oder primärer Erweiterung hinzu. Weitere Informationen und ein Beispiel für eine sekundäre Erstellungserweiterung finden Sie im Userwizard-Beispiel im Platform SDK.

Entwicklerzielgruppe

In dieser Dokumentation wird davon ausgegangen, dass der Leser mit der COM-Operation- und Komponentenentwicklung mit C++vertraut ist. Es ist derzeit nicht möglich, eine Erweiterung für den Active Directory-Objekterstellungs-Assistenten mit Visual Basic zu erstellen.

Erstellen einer Active Directory-Objekterstellungserweiterung

Sowohl primäre als auch sekundäre Objekterstellungserweiterungen sind COM-In-Proc-Server, die bestimmte Schnittstellen implementieren und mit Active Directory Domain Services registriert sind.

So erstellen und installieren Sie eine Objekterstellungserweiterung

  1. Erstellen Sie die DLL für die Objekterstellung. Eine Objekterstellungserweiterung ist ein COM-In-Proc-Server, der mindestens die IDsAdminNewObjExt-Schnittstelle implementiert. Weitere Informationen finden Sie unter Implementieren des ObjekterstellungserweiterungS-COM-Objekts.
  2. Installieren Sie die Erstellungserweiterung auf Computern, auf denen die Erstellungserweiterung verwendet werden soll. Erstellen Sie dazu ein Microsoft Windows Installer-Paket für die Erstellungserweiterungs-DLL und stellen Sie das Paket entsprechend mithilfe der Gruppenrichtlinie bereit. Weitere Informationen finden Sie unter Verteilen von Benutzeroberflächenkomponenten.
  3. Registrieren Sie die Erstellungserweiterung in der Windows Registrierung und mit Active Directory Domain Services. Weitere Informationen finden Sie unter Registrieren der Objekterstellungserweiterung.

Verwenden eines Objekterstellungs-Assistenten

Ein Objekterstellungs-Assistent kann auch aus einer anderen Anwendung als den administrativen MMC-Snap-Ins von Active Directory Domain Services aufgerufen werden. Weitere Informationen finden Sie unter "Aufrufen von Erstellungs-Assistenten" aus Ihrer Anwendung.

Wenn ein Erstellungs-Assistent für eine Objektklasse nicht registriert ist, stellen die administrativen Snap-Ins einen generischen Erstellungs-Assistenten bereit. Der generische Erstellungs-Assistent wird zur Laufzeit aus der Liste der obligatorischen Eigenschaften für die erstellte Objektklasse erstellt. Für jede obligatorische Eigenschaft wird eine Seite der Benutzeroberfläche hinzugefügt. Der generische Erstellungs-Assistent ist nicht erweiterbar. Wenn die Erweiterung erforderlich ist, muss sie durch eine primäre Objekterstellungserweiterung ersetzt werden.