Função NetGetAnyDCName (lmaccess.h)
A função NetGetAnyDCName retorna o nome de qualquer controlador de domínio (DC) para um domínio que é diretamente confiável pelo servidor especificado.
Aplicativos que dão suporte a nomes de estilo DNS devem chamar a função DsGetDcName . Essa função pode localizar qualquer DC em qualquer domínio, independentemente de o domínio ser diretamente confiável pelo servidor especificado.
Sintaxe
NET_API_STATUS NET_API_FUNCTION NetGetAnyDCName(
LPCWSTR ServerName,
LPCWSTR DomainName,
LPBYTE *Buffer
);
Parâmetros
ServerName
Ponteiro para uma cadeia de caracteres constante que especifica o nome DNS ou NetBIOS do servidor remoto no qual a função deve ser executada. Se esse parâmetro for NULL, o computador local será usado. Para obter mais informações, consulte a seção Comentários a seguir.
DomainName
Ponteiro para uma cadeia de caracteres constante que especifica o nome do domínio. Se esse parâmetro for NULL, o nome do controlador de domínio para o domínio primário será usado. Para obter mais informações, consulte a seção Comentários a seguir.
Buffer
Retornar valor
Se a função for bem-sucedida, o valor retornado será NERR_Success.
Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de erro.
| Código de retorno | Descrição |
|---|---|
|
Nenhum controlador de domínio foi encontrado. |
|
O domínio especificado não é um domínio confiável. |
|
O lado do cliente da relação de confiança está quebrado. |
|
O lado do servidor da relação de confiança está quebrado ou a senha está quebrada. |
|
O servidor que respondeu não é um controlador de domínio adequado do domínio especificado. |
Comentários
Nenhuma associação de grupo especial é necessária para executar com êxito a função NetGetAnyDCName .
Se servername especificar uma estação de trabalho autônoma ou um servidor autônomo, nenhum nome de domínio será válido.
Se servername especificar uma estação de trabalho que seja membro de um domínio ou um servidor que seja membro de um domínio, o nome de domínio deverá estar no mesmo domínio que servername.
Se servername especificar um controlador de domínio, o nome de domínio deverá ser um dos domínios confiáveis pelo domínio para o qual o servidor é um controlador. O controlador de domínio que essa chamada localiza está operacional pelo menos uma vez durante essa chamada.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | lmaccess.h (inclua Lm.h) |
| Biblioteca | Netapi32.lib |
| DLL | Netapi32.dll |