Inscription de l’extension de création d’objet

Lorsqu’une DLL d’extension de création d’objet dans services de domaine Active Directory est créée, elle doit être inscrite auprès du Registre Windows et services de domaine Active Directory pour que les composants logiciels enfichables MMC d’administration ET COM et Active Directory soient conscients de l’extension.

Inscription dans le Registre Windows

Comme tous les serveurs COM, une extension de création d’objet doit être inscrite dans le Registre Windows. L’extension est inscrite sous la clé suivante :

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

«< extension CLSID> » est la représentation sous forme de chaîne du CLSID tel que produit par la fonction StringFromCLSID . «< chemin d’accès d’extension> » contient le chemin d’accès et le nom de fichier de la DLL d’extension. La valeur ThreadingModel pour toutes les extensions de création d’objet doit être « Apartment ».

Inscription auprès de services de domaine Active Directory

L’inscription de l’extension de création d’objet est spécifique à un paramètre régional. Si l’extension de création d’objet s’applique à tous les paramètres régionaux, elle doit être inscrite dans l’objet displaySpecifier de la classe d’objet dans tous les sous-conteneurs de paramètres régionaux du conteneur DisplaySpecifiers. Si l’extension de création d’objet est localisée pour certains paramètres régionaux, inscrivez-la dans l’objet displaySpecifier dans le sous-conteneur de ces paramètres régionaux. Pour plus d’informations sur le conteneur DisplaySpecifiers et les paramètres régionaux, consultez Display Specifiers and DisplaySpecifiers Container.

Une extension de création d’objet peut être inscrite sous deux attributs DisplaySpecifier. Il s’agit de createWizard et createWizardExt.

L’attribut creationWizard identifie les extensions de création d’objets principaux pour remplacer l’Assistant Création d’objets existants ou natifs dans les composants logiciels enfichables d’administration Active Directory. Une extension de création principale fournit le premier ensemble de pages et est hébergée de la même manière que les pages natives. Cet attribut est à valeur unique et nécessite le format suivant :

<CLSID>

Le «< CLSID> » est la représentation sous forme de chaîne du CLSID de l’objet COM, tel que produit par la fonction StringFromCLSID .

L’attribut createWizardExt identifie les extensions de création d’objets secondaires. Une extension de création secondaire ajoute des pages d’Assistant aux pages natives ou à l’extension principale. Cet attribut est à valeurs multiples et nécessite le format suivant :

<order number>,<CLSID>

Le «< numéro> de commande » est un nombre non signé qui représente la position de la page dans l’Assistant. Lorsqu’un Assistant création s’affiche, les valeurs sont triées à l’aide d’une comparaison du «< numéro> de commande » de chaque valeur. Si plusieurs valeurs ont le même «< numéro de> commande », ces pages sont chargées dans l’ordre dans lequel elles sont lues à partir du serveur Active Directory. Si possible, vous devez utiliser un «< numéro> de commande » non existant (c’est-à-dire qui n’a pas été utilisé par d’autres valeurs de la propriété). Il n’y a pas de position de départ prescrite, et les intervalles sont autorisés dans la séquence «< numéro de> commande ».

Le «< CLSID> » est la représentation sous forme de chaîne du CLSID de l’objet COM, tel que produit par la fonction StringFromCLSID .