Função DsBindWithCredA (ntdsapi.h)

Artigo
11/20/2024

A função DsBindWithCred é associada a um controlador de domínio usando as credenciais especificadas.

Sintaxe

NTDSAPI DWORD DsBindWithCredA(
  [in, optional] LPCSTR                   DomainControllerName,
  [in, optional] LPCSTR                   DnsDomainName,
  [in, optional] RPC_AUTH_IDENTITY_HANDLE AuthIdentity,
  [out]          HANDLE                   *phDS
);

Parâmetros

[in, optional] DomainControllerName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome DNS totalmente qualificado do domínio a ser associado. Para obter mais informações sobre esse parâmetro, consulte a descrição do DomainControllerName no tópico DsBind.

[in, optional] DnsDomainName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome DNS totalmente qualificado do domínio ao qual associar. Para obter mais informações sobre esse parâmetro, consulte a descrição DnsDomainName no tópico DsBind.

Esse parâmetro é necessário para proteger uma autenticação Kerberos.

[in, optional] AuthIdentity

Contém um valor RPC_AUTH_IDENTITY_HANDLE que representa as credenciais a serem usadas para a associação. O

função DsMakePasswordCredentials é usada para obter esse valor. Se esse parâmetro for NULL, as credenciais do thread de chamada serão usadas.

DsUnBind deve ser chamado antes de liberar esse identificador com a função DsFreePasswordCredentials .

[out] phDS

Endereço de um HANDLE valor que recebe o identificador de associação. Para fechar esse identificador, passe-o para a função DsUnBind.

Valor de retorno

Retorna ERROR_SUCCESS se tiver êxito ou um código de erro do Windows ou RPC, caso contrário. Veja a seguir os códigos de erro mais comuns.

Observações

Nota

O cabeçalho ntdsapi.h define DsBindWithCred como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
servidor com suporte mínimo	Windows Server 2008
da Plataforma de Destino	Windows
cabeçalho	ntdsapi.h
biblioteca	Ntdsapi.lib
de DLL	Ntdsapi.dll

Consulte também

DOMAIN_CONTROLLER_INFO

Funções de gerenciamento de replicação e controlador de domínio

DsBind

DsFreePasswordCredentials

DsGetDcName

DsMakePasswordCredentials

DsUnBind

autenticação mútua usando Kerberos

Compartilhar via