Interfaz IADsNameTranslate (iads.h)

Artículo
08/24/2023

La interfaz IADsNameTranslate traduce nombres distintivos (DN) entre varios formatos, tal y como se define en la enumeración ADS_NAME_TYPE_ENUM . La característica está disponible para los objetos de Active Directory.

Las traducciones de nombres se realizan en el servidor de directorios. Para traducir un DN, comunique con el servidor mediante un objeto IADsNameTranslate y especifique qué objeto es de interés y qué formato se desea. El siguiente es el proceso general para usar la interfaz IADsNameTranslate .

En primer lugar, cree una instancia del objeto IADsNameTranslate .

En segundo lugar, inicialice el objeto IADsNameTranslate especificando el servidor de directorios mediante .
Métodos IADsNameTranslate::Init o IADsNameTranslate::InitEx .

En tercer lugar, establezca el objeto de directorio en el servidor especificando el nombre con el método IADsNameTranslate::Set y el formato con el método IADsNameTranslate::SetEx .

En cuarto lugar, recupere el nombre del objeto en el formato especificado con el método IADsNameTranslate::Get o IADsNameTranslate::GetEx .

En el ejemplo de código siguiente se muestra cómo crear un objeto IADsNameTranslate en Visual C++, Visual Basic y VBScript/Active Server Pages.

Nota Los elementos de formato definidos en la enumeración ADS_NAME_TYPE_ENUM y usados por IADsNameTranslate no son equivalentes y no son intercambiables con los elementos de formato utilizados por la función DsCrackName . No confunda el uso adecuado de estos formatos de elementos con nombre similar, pero no intercambiables.

Herencia

La interfaz IADsNameTranslate hereda de la interfaz IDispatch . IADsNameTranslate también tiene estos tipos de miembros:

Métodos

La interfaz IADsNameTranslate tiene estos métodos.


IADsNameTranslate::Get Recupera el nombre de un objeto de directorio en el formato especificado.
IADsNameTranslate::GetEx Obtiene los nombres de objeto en el formato especificado.
IADsNameTranslate::Init Inicializa un objeto de traducción de nombre mediante el enlace a un servidor de directorios, un dominio o un catálogo global especificados mediante las credenciales del usuario actual.
IADsNameTranslate::InitEx Inicializa un objeto de traducción de nombre mediante el enlace a un servidor de directorios, un dominio o un catálogo global especificados mediante la credencial de usuario especificada.
IADsNameTranslate::Set Dirige el servicio de directorio para configurar un objeto especificado para la traducción de nombres.
IADsNameTranslate::SetEx Establece una matriz de objetos para la traducción de nombres.