Compartilhar via


Interface IADsNameTranslate (iads.h)

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.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho iads.h

Confira também

ADS_NAME_TYPE_ENUM

Cocreateinstance

Métodos da propriedade IADsNameTranslate

IADsNameTranslate Interface

IADsNameTranslate::Get

IADsNameTranslate::GetEx

IADsNameTranslate::Init

IADsNameTranslate::InitEx

IADsNameTranslate::Set

IADsNameTranslate::SetEx

IDispatch