Objekterstellungs-Assistenten

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, Neueund die zu erstellende Objektklasse 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 wie Benutzer- und organizationalUnit-stellt das Active Directory-Snap-In "Benutzer und Computer" 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 er für die Klasse nicht vorhanden ist: Der vorhandene Assistent wird durch das Erstellen einer primären Objekterstellungserweiterungersetzt. Eine primäre Erstellungserweiterung stellt den ersten Satz von Seiten bereit und wird auf die gleiche Weise wie systemeigene 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 Objekterstellungserweiterungerweitert werden. Eine sekundäre Erstellungserweiterung fügt den systemeigenen 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.

Entwicklergruppe

In dieser Dokumentation wird davon ausgegangen, dass der Reader 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 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 bei Active Directory Domain Services registriert sind.

So erstellen und installieren Sie eine Objekterstellungserweiterung

1. Erstellen Sie die Objekterstellungserweiterungs-DLL. Eine Objekterstellungserweiterung ist ein COM-In-Proc-Server, der mindestens die IDsAdminNewObjExt--Schnittstelle implementiert. Weitere Informationen finden Sie unter Implementieren der Objekterstellungserweiterung COM-Objekt.
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 Komponenten der Benutzeroberfläche.
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 administrativen 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 erstellte Objektklasse erstellt. Für jede obligatorische Eigenschaft wird der Benutzeroberfläche eine Seite hinzugefügt. Der generische Erstellungs-Assistent ist nicht erweiterbar. Wenn die Erweiterbarkeit erforderlich ist, muss sie durch eine primäre Objekterstellungserweiterung ersetzt werden.