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 er das Kontextmenü für den Container öffnet, in dem das neue Objekt erstellt wird, Neu auswählt und die Zu erstellende Objektklasse auswählt. 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 gängige Klassen, z. B. user und organizationalUnit, stellt das Active Directory-Benutzer und -Computer-Snap-In einen Standardsatz von Erstellungs-Assistenten bereit.

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

• Ersetzen Sie einen vorhandenen Assistenten, oder geben Sie einen an, wenn kein Assistent für die Klasse vorhanden ist: Der vorhandene Assistent wird ersetzt, indem eine erweiterung für die Primäre Objekterstellung erstellt wird. Eine primäre Erstellungserweiterung stellt den ersten Satz von Seiten bereit und wird auf die gleiche Weise wie native Seiten gehostet. 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 erweiterung für die Erstellung eines sekundären Objekts 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 Userwizard-Beispiel im Platform SDK.

Entwicklerzielgruppe

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

Erstellen einer Erweiterung für die Erstellung von Active Directory-Objekten

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

So erstellen und installieren Sie eine Objekterstellungserweiterung

1. Erstellen Sie die DLL für die Objekterstellungserweiterung. Eine Objekterstellungserweiterung ist ein COM-In-Proc-Server, der mindestens die IDsAdminNewObjExt-Schnittstelle implementiert. Weitere Informationen finden Sie unter Implementieren des COM-Objekts für die Objekterstellungserweiterung.
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 DLL für die Erstellungserweiterung, 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 bei 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 von Active Directory Domain Services aufgerufen werden. Weitere Informationen finden Sie unter Aufrufen von Erstellungs-Assistenten aus Ihrer Anwendung.

Wenn ein Erstellungs-Assistent nicht für eine Objektklasse registriert ist, stellen die Verwaltungs-Snap-Ins einen generischen Erstellungs-Assistenten bereit. 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 Generische Erstellungs-Assistent ist nicht erweiterbar. Wenn Erweiterbarkeit erforderlich ist, muss sie durch eine Erweiterung für die Primäre Objekterstellung ersetzt werden.