Função DsBindA (ntdsapi.h)

Artigo
03/08/2023

A função DsBind é associada a um controlador de domínio. O DsBind usa as credenciais de processo padrão para associar ao controlador de domínio. Para especificar credenciais alternativas, use a função DsBindWithCred .

Sintaxe

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

Parâmetros

[in, optional] DomainControllerName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do controlador de domínio ao qual associar. Esse nome pode ser o nome do controlador de domínio ou o nome DNS totalmente qualificado do controlador de domínio. Qualquer tipo de nome pode, opcionalmente, ser precedido por dois caracteres de barra invertida. Todos os exemplos a seguir representam nomes de controlador de domínio formatados corretamente:

"FAB-DC-01"
"\\FAB-DC-01"
"FAB-DC-01.fabrikam.com"
"\\FAB-DC-01.fabrikam.com"

Este parâmetro pode ser NULL. Para obter mais informações, consulte Comentários.

[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. Este parâmetro pode ser NULL. Para obter mais informações, consulte Comentários.

[out] phDS

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

Retornar valor

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.

Comentários

O comportamento da função DsBind é determinado pelo conteúdo dos parâmetros DomainControllerName e DnsDomainName . A lista a seguir descreve o comportamento dessa função com base no conteúdo desses parâmetros.

DomainControllerName	DnsDomainName	Descrição
NULL	NULL	O DsBind tentará associar a um servidor de catálogo global na floresta do computador local.
(valor)	NULL	O DsBind tentará associar ao controlador de domínio especificado pelo parâmetro DomainControllerName .
NULL	(valor)	O DsBind tentará associar a qualquer controlador de domínio no domínio especificado pelo parâmetro DnsDomainName .
(valor )	(valor)	O parâmetro DomainControllerName tem precedência. O DsBind tentará associar ao controlador de domínio especificado pelo parâmetro DomainControllerName .

Observação

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	ntdsapi.h
Biblioteca	Ntdsapi.lib
DLL	Ntdsapi.dll