Função DnsValidateServerStatus (windns.h)

Artigo
08/27/2023

A função DnsValidateServerStatus valida um endereço IP como um servidor DNS adequado.

Sintaxe

DNS_STATUS DnsValidateServerStatus(
  [in]  PSOCKADDR server,
  [in]  PCWSTR    queryName,
  [out] PDWORD    serverStatus
);

Parâmetros

[in] server

Um ponteiro para um SOCKADDR que contém o endereço IPv4 ou IPv6 do servidor DNS a ser examinado.

[in] queryName

Um ponteiro para uma cadeia de caracteres Unicode que representa o FQDN (nome de domínio totalmente qualificado) do proprietário do conjunto de registros consultado.

[out] serverStatus

Um ponteiro para um DWORD que representa o status de validação de consulta.

Valor	Significado
ERROR_SUCCESS	Nenhum erro. A chamada foi bem-sucedida.
DNS_VALSVR_ERROR_INVALID_ADDR	Servidor O endereço IP era inválido.
DNS_VALSVR_ERROR_INVALID_NAME	queryName O FQDN era inválido.
DNS_VALSVR_ERROR_UNREACHABLE	O servidor DNS estava inacessível.
DNS_VALSVR_ERROR_NO_RESPONSE	Tempo limite aguardando a resposta do servidor DNS.
DNS_VALSVR_ERROR_NO_AUTH	O servidor DNS não foi autoritativo ou queryName não foi encontrado.
DNS_VALSVR_ERROR_REFUSED	O servidor DNS recusou a consulta.
DNS_VALSVR_ERROR_NO_TCP	A consulta TCP não retornou ERROR_SUCCESS depois que o sistema de validação já havia concluído uma consulta bem-sucedida para o servidor DNS usando UDP.
DNS_VALSVR_ERROR_UNKNOWN	Ocorreu um erro desconhecido.

Valor retornado

A função DnsValidateServerStatus tem os seguintes valores de retorno possíveis:

Requisitos


Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	windns.h
Biblioteca	Dnsapi.lib
DLL	Dnsapi.dll

Confira também

Funções DNS

Compartilhar via