Interface IADsNameTranslate (iads.h)

Artigo
08/24/2023

A interface IADsNameTranslate converte DNs (nomes distintos) entre vários formatos, conforme definido na enumeração ADS_NAME_TYPE_ENUM . O recurso está disponível para objetos no Active Directory.

As traduções de nome são executadas no servidor de diretório. Para traduzir um DN, comunique-se com o servidor por meio de um objeto IADsNameTranslate e especifique qual objeto é de interesse e qual formato é desejado. Veja a seguir o processo geral para usar a interface IADsNameTranslate .

Primeiro, crie uma instância do objeto IADsNameTranslate .

Em segundo lugar, inicialize o objeto IADsNameTranslate especificando o servidor de diretório usando o
Métodos IADsNameTranslate::Init ou IADsNameTranslate::InitEx .

Em terceiro lugar, defina o objeto de diretório no servidor especificando o nome com o método IADsNameTranslate::Set e o formato com o método IADsNameTranslate::SetEx .

Em quarto lugar, recupere o nome do objeto no formato especificado com o método IADsNameTranslate::Get ou IADsNameTranslate::GetEx .

O exemplo de código a seguir mostra como criar um objeto IADsNameTranslate no Visual C++, Visual Basic e VBScript/Active Server Pages.

Nota Os elementos de formato definidos na enumeração ADS_NAME_TYPE_ENUM e usados por IADsNameTranslate não são equivalentes e não são intercambiáveis com os elementos de formato usados pela função DsCrackName . Não confunda o uso adequado desses formatos de elementos nomeados da mesma forma, mas não intercambiáveis.

Herança

A interface IADsNameTranslate herda da interface IDispatch . IADsNameTranslate também tem estes tipos de membros:

Métodos

A interface IADsNameTranslate tem esses métodos.


IADsNameTranslate::Get Recupera o nome de um objeto de diretório no formato especificado.
IADsNameTranslate::GetEx Obtém os nomes de objeto no formato especificado.
IADsNameTranslate::Init Inicializa um objeto de conversão de nome associando-se a um servidor de diretório, domínio ou catálogo global especificado, usando as credenciais do usuário atual.
IADsNameTranslate::InitEx Inicializa um objeto de conversão de nome associando-se a um servidor de diretório, domínio ou catálogo global especificado, usando a credencial de usuário especificada.
IADsNameTranslate::Set Direciona o serviço de diretório para configurar um objeto especificado para tradução de nome.
IADsNameTranslate::SetEx Estabelece uma matriz de objetos para conversão de nomes.