Interface IADsNameTranslate (iads.h)

Article
08/24/2023

L’interface IADsNameTranslate traduit les noms uniques (DN) entre différents formats tels que définis dans l’énumération ADS_NAME_TYPE_ENUM. La fonctionnalité est disponible pour les objets dans Active Directory.

Les traductions de noms sont effectuées sur le serveur d’annuaire. Pour traduire un DN, communiquez avec le serveur au moyen d’un objet IADsNameTranslate et spécifiez l’objet qui vous intéresse et le format souhaité. Voici le processus général d’utilisation de l’interface IADsNameTranslate .

Tout d’abord, créez une instance de l’objet IADsNameTranslate.

Ensuite, initialisez l’objet IADsNameTranslate en spécifiant le serveur d’annuaire à l’aide du
Méthodes IADsNameTranslate::Init ou IADsNameTranslate::InitEx .

Troisièmement, définissez l’objet répertoire sur le serveur en spécifiant le nom avec la méthode IADsNameTranslate::Set et le format avec la méthode IADsNameTranslate::SetEx .

Quatrièmement, récupérez le nom de l’objet dans le format spécifié avec la méthode IADsNameTranslate::Get ou IADsNameTranslate::GetEx .

L’exemple de code suivant montre comment créer un objet IADsNameTranslate dans Visual C++, Visual Basic et VBScript/Active Server Pages.

Note Les éléments de format tels que définis dans l’énumération ADS_NAME_TYPE_ENUM et utilisés par IADsNameTranslate ne sont pas équivalents et ne sont pas interchangeables avec les éléments de format utilisés par la fonction DsCrackName . Ne confondez pas l’utilisation appropriée de ces formats d’éléments nommés de même nom, mais non interchangeables.

Héritage

L’interface IADsNameTranslate hérite de l’interface IDispatch. IADsNameTranslate a également les types de membres suivants :

Méthodes

L’interface IADsNameTranslate utilise ces méthodes.


IADsNameTranslate::Get Récupère le nom d’un objet d’annuaire au format spécifié.
IADsNameTranslate::GetEx Obtient les noms d’objets dans le format spécifié.
IADsNameTranslate::Init Initialise un objet de traduction de nom en lisant un serveur d’annuaire, un domaine ou un catalogue global spécifié, à l’aide des informations d’identification de l’utilisateur actuel.
IADsNameTranslate::InitEx Initialise un objet de traduction de nom en lisant un serveur d’annuaire, un domaine ou un catalogue global spécifié, à l’aide des informations d’identification utilisateur spécifiées.
IADsNameTranslate::Set Indique au service d’annuaire de configurer un objet spécifié pour la traduction de noms.
IADsNameTranslate::SetEx Établit un tableau d’objets pour la traduction de noms.