Função DsBindA (ntdsapi.h)
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"
[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 |
Confira também
Funções de gerenciamento de replicação e controlador de domínio