DnsValidateServerStatus function

The DnsValidateServerStatus function validates an IP address as a suitable DNS server.

Syntax

DNS_STATUS DnsValidateServerStatus(
  PSOCKADDR server,
  PCWSTR    queryName,
  PDWORD    serverStatus
);

Parameters

server

A pointer to a SOCKADDR that contains the DNS server IPv4 or IPv6 address to be examined.

queryName

A pointer to a Unicode string that represents the fully qualified domain name (FQDN) of the owner of the record set that is queried.

serverStatus

A pointer to a DWORD that represents the query validation status.

Value Meaning
ERROR_SUCCESS
No errors. The call was successful.
DNS_VALSVR_ERROR_INVALID_ADDR
server IP address was invalid.
DNS_VALSVR_ERROR_INVALID_NAME
queryName FQDN was invalid.
DNS_VALSVR_ERROR_UNREACHABLE
DNS server was unreachable.
DNS_VALSVR_ERROR_NO_RESPONSE
Timeout waiting for the DNS server response.
DNS_VALSVR_ERROR_NO_AUTH
DNS server was not authoritative or queryName was not found.
DNS_VALSVR_ERROR_REFUSED
DNS server refused the query.
DNS_VALSVR_ERROR_NO_TCP
The TCP query did not return ERROR_SUCCESS after the validation system had already completed a successful query to the DNS server using UDP.
DNS_VALSVR_ERROR_UNKNOWN
An unknown error occurred.

Return Value

The DnsValidateServerStatus function has the following possible return values:

Requirements

   
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header windns.h
Library Dnsapi.lib
DLL Dnsapi.dll

See Also

DNS Functions