Função NetGetAnyDCName (lmaccess.h)

Artigo
03/05/2024

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
ERROR_NO_LOGON_SERVERS	Nenhum controlador de domínio foi encontrado.
ERROR_NO_SUCH_DOMAIN	O domínio especificado não é um domínio confiável.
ERROR_NO_TRUST_LSA_SECRET	O lado do cliente da relação de confiança está quebrado.
ERROR_NO_TRUST_SAM_ACCOUNT	O lado do servidor da relação de confiança está quebrado ou a senha está quebrada.
ERROR_DOMAIN_TRUST_INCONSISTENT	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