Registrieren der Objekterstellungserweiterung

Wenn eine DLL der Objekterstellungserweiterung in Active Directory Domain Services erstellt wird, muss sie bei der Windows-Registrierung registriert und Active Directory Domain Services werden, damit COM und die Active Directory-Verwaltungs-MMC-Snap-Ins auf die Erweiterung aufmerksam werden.

Registrierung in der Windows-Registrierung

Wie alle COM-Server muss eine Objekterstellungserweiterung in der Windows-Registrierung registriert werden. Die Erweiterung wird unter dem folgenden Schlüssel registriert:

HKEY_CLASSES_ROOT
   CLSID
      <extension CLSID>
         InProcServer32
            (Default) = <extension path>
            ThreadingModel = Apartment

"<extension CLSID>" ist die Zeichenfolgendarstellung der CLSID, die von der StringFromCLSID-Funktion erzeugt wird. "<Erweiterungspfad>" enthält den Pfad und dateinamen der Erweiterungs-DLL. Der ThreadingModel-Wert für alle Objekterstellungserweiterungen muss "Apartment" sein.

Registrieren bei Active Directory Domain Services

Die Registrierung der Objekterstellungserweiterung ist spezifisch für ein Gebietsschema. Wenn die Objekterstellungserweiterung für alle Gebietsschemas gilt, muss sie im displaySpecifier-Objekt der Objektklasse in allen Gebietsschemauntercontainern im DisplaySpecifiers-Container registriert werden. Wenn die Objekterstellungserweiterung für ein bestimmtes Gebietsschema lokalisiert ist, registrieren Sie sie im displaySpecifier-Objekt im Untercontainer dieses Gebietsschemas. Weitere Informationen zum DisplaySpecifiers-Container und den Gebietsschemas finden Sie unter Display Specifiers und DisplaySpecifiers Container.

Es gibt zwei DisplaySpecifier-Attribute, unter denen eine Objekterstellungserweiterung registriert werden kann. Dies sind creationWizard und createWizardExt.

Das creationWizard-Attribut identifiziert Primäre Objekterstellungserweiterungen, um den vorhandenen oder nativen Assistenten zum Erstellen von Objekten in Active Directory-Verwaltungs-Snap-Ins zu ersetzen. Eine primäre Erstellungserweiterung stellt den ersten Satz von Seiten bereit und wird auf die gleiche Weise wie native Seiten gehostet. Dieses Attribut ist einwertig und erfordert das folgende Format:

<CLSID>

Die "<CLSID>" ist die Zeichenfolgendarstellung der CLSID des COM-Objekts, wie sie von der StringFromCLSID-Funktion erzeugt wird.

Das createWizardExt-Attribut identifiziert sekundäre Objekterstellungserweiterungen. Eine sekundäre Erstellungserweiterung fügt den nativen Seiten oder der primären Erweiterung Assistentenseiten hinzu. Dieses Attribut ist mehrwertt und erfordert das folgende Format:

<order number>,<CLSID>

Die "<Bestellnummer>" ist eine nummer ohne Vorzeichen, die die Position der Seite im Assistenten darstellt. Wenn ein Erstellungs-Assistent angezeigt wird, werden die Werte anhand eines Vergleichs der "<Bestellnummer>" der einzelnen Werte sortiert. Wenn mehrere Werte dieselbe "<Bestellnummer>" aufweisen, werden diese Seiten in der Reihenfolge geladen, in der sie vom Active Directory-Server gelesen werden. Wenn möglich, sollten Sie eine nicht vorhandene "<Bestellnummer>" verwenden (d. a. eine, die von anderen Werten in der -Eigenschaft nicht verwendet wurde). Es gibt keine vorgeschriebene Startposition, und in der Sequenz "<Bestellnummer>" sind Lücken zulässig.

Die "<CLSID>" ist die Zeichenfolgendarstellung der CLSID des COM-Objekts, wie sie von der StringFromCLSID-Funktion erzeugt wird.