Objekterstellungs-Assistenten

In den administrativen MMC-Snap-Ins von Active Directory Domain Services kann der Benutzer neue Objekte in einem Verzeichnis erstellen, indem er das Kontextmenü für den Container öffnet, in dem das neue Objekt erstellt wird. Wählen Sie Neu aus, und wählen Sie die Klasse des zu erstellenden Objekts aus. Beim Erstellen neuer Instanzen eines Objekts wird der Objekterstellungs-Assistent gestartet. Jede Objektklasse kann die Verwendung eines bestimmten Erstellungs-Assistenten oder einen generischen Erstellungs-Assistenten angeben. Für allgemeine Klassen, z. B. user und organizationalUnit,stellt das Active Directory-Benutzer und -Computer-Snap-In einen Standardsatz von Erstellungs-Assistenten zur Bereitstellung.

Es gibt zwei Möglichkeiten, einen Erstellungs-Assistenten zu erweitern:

  • Ersetzen Sie einen vorhandenen Assistenten, oder geben Sie einen assistenten an, wenn dieser für die Klasse nicht vorhanden ist: Der vorhandene Assistent wird ersetzt, indem eine Primäre Objekterstellungserweiterung erstellt wird. Eine primäre Erstellungserweiterung stellt den ersten Satz von Seiten zur Seite und wird auf die gleiche Weise gehostet wie native Seiten. Eine primäre Erstellungserweiterung unterstützt auch den Erweiterbarkeitsmechanismus, sodass andere Erweiterungen des Erstellungs-Assistenten 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 Den nativen Seiten oder der primären Erweiterung Assistentenseiten hinzu. Weitere Informationen und ein Beispiel für eine sekundäre Erstellungserweiterung finden Sie im Beispiel userwizard im Platform SDK.

Entwicklerzielgruppe

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

Erstellen einer Active Directory-Objekterstellungserweiterung

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

So erstellen und installieren Sie eine Objekterstellungserweiterung

  1. Erstellen Sie die Erweiterungs-DLL für die Objekterstellung. Eine Objekterstellungserweiterung ist ein COM-In-Proc-Server, der mindestens die IDsAdminNewObjExt-Schnittstelle implementiert. Weitere Informationen finden Sie unter Implementing the Object Creation Extension COM Object.
  2. Installieren Sie die Erstellungserweiterung auf Computern, auf denen die Erstellungserweiterung verwendet werden soll. Erstellen Sie hierzu ein Microsoft Windows Installer-Paket für die Erweiterungs-DLL für die Erstellung, und stellen Sie das Paket entsprechend mithilfe der Gruppenrichtlinie zur Verfügung. Weitere Informationen finden Sie unter Verteilen Benutzeroberfläche -Komponenten.
  3. Registrieren Sie die Erstellungserweiterung in Windows Registrierung und Active Directory Domain Services. Weitere Informationen finden Sie unter Registrieren der Objekterstellungserweiterung.

Verwenden eines Objekterstellungs-Assistenten

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

Wenn kein Erstellungs-Assistent für eine Objektklasse registriert ist, stellen die administrativen Snap-Ins einen generischen Erstellungs-Assistenten zur Verfügung. Der Assistent für die generische Erstellung wird zur Laufzeit aus der Liste der obligatorischen Eigenschaften für die Klasse des erstellten Objekts erstellt. Für jede obligatorische Eigenschaft wird der Benutzeroberfläche eine Seite hinzugefügt. Der Assistent für die generische Erstellung ist nicht erweiterbar. Wenn Erweiterbarkeit erforderlich ist, muss sie durch eine Primäre Objekterstellungserweiterung ersetzt werden.