Registrazione dell'estensione per la creazione di oggetti

Quando viene creata una DLL dell'estensione per la creazione di oggetti in Dominio di Active Directory Services, deve essere registrata nel Registro di sistema di Windows e Dominio di Active Directory Services per rendere COM e gli snap-in MMC amministrativi di Active Directory che conoscono l'estensione.

Registrazione nel Registro di sistema di Windows

Come tutti i server COM, un'estensione per la creazione di oggetti deve essere registrata nel Registro di sistema di Windows. L'estensione viene registrata nella chiave seguente:

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

"<EXTENSION CLSID>" è la rappresentazione di stringa del CLSID prodotto dalla funzione StringFromCLSID . "<percorso> di estensione" contiene il percorso e il nome file della DLL dell'estensione. Il valore ThreadingModel per tutte le estensioni per la creazione di oggetti deve essere "Apartment".

Registrazione con i servizi di Dominio di Active Directory

La registrazione dell'estensione per la creazione di oggetti è specifica per una sola impostazione locale. Se l'estensione per la creazione di oggetti si applica a tutte le impostazioni locali, deve essere registrata nell'oggetto displaySpecifier della classe oggetto in tutti i sottocontenitori delle impostazioni locali nel contenitore DisplaySpecifiers. Se l'estensione per la creazione dell'oggetto viene localizzata per determinate impostazioni locali, registrarla nell'oggetto displaySpecifier nel sottocontenitore delle impostazioni locali. Per altre informazioni sul contenitore e le impostazioni locali DisplaySpecifiers, vedere Display Specifiers e DisplaySpecifiers Container.

Esistono due attributi DisplaySpecifier in cui è possibile registrare un'estensione per la creazione di oggetti. Si tratta di creationWizard e createWizardExt.

L'attributo creationWizard identifica le estensioni di creazione di oggetti primari per sostituire la creazione guidata di oggetti nativa o esistente negli snap-in amministrativi di Active Directory. Un'estensione di creazione primaria fornisce il primo set di pagine e viene ospitato nello stesso modo delle pagine native. Questo attributo è a valore singolo e richiede il formato seguente:

<CLSID>

"<CLSID" è la rappresentazione di stringa del CLSID> dell'oggetto COM, come prodotto dalla funzione StringFromCLSID .

L'attributo createWizardExt identifica le estensioni per la creazione di oggetti secondari. Un'estensione di creazione secondaria aggiunge pagine della procedura guidata alle pagine native o all'estensione primaria. Questo attributo è multivalore e richiede il formato seguente:

<order number>,<CLSID>

Il "<numero> ordine" è un numero senza segno che rappresenta la posizione della pagina nella procedura guidata. Quando viene visualizzata una creazione guidata, i valori vengono ordinati usando un confronto del "<numero> di ordine" di ogni valore. Se più valori hanno lo stesso "<numero> di ordine", tali pagine vengono caricate nell'ordine in cui vengono lette dal server Active Directory. Se possibile, è consigliabile usare un "<numero> di ordine" non esistente, ovvero uno che non è stato usato da altri valori nella proprietà . Non esiste una posizione iniziale prestabilita e le lacune sono consentite nella sequenza "<numero> ordine".

"<CLSID" è la rappresentazione di stringa del CLSID> dell'oggetto COM, come prodotto dalla funzione StringFromCLSID .