Função DsBindA (ntdsapi.h)

Artigo
11/20/2024

A função DsBind é associada a um controlador de domínio.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"

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

[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

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	DsBind tentará associar a um servidor de catálogo global na floresta do computador local.
(valor)	NULL	DsBind tentará associar ao controlador de domínio especificado pelo parâmetro DomainControllerName.
NULL	(valor)	DsBind tentará associar a qualquer controlador de domínio no domínio especificado por parâmetro DnsDomainName.
(valor )	(valor)	O parâmetro DomainControllerName tem precedência. DsBind tentará associar ao controlador de domínio especificado pelo parâmetro DomainControllerName.

Nota

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. 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

DsBindWithCred

DsGetDcName

DsUnBind

Compartilhar via