Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

DnsValidateServerStatus function

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

Syntax


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

Parameters

server [in]

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

queryName [in]

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 [out]

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

ValueMeaning
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:

ERROR_SUCCESS
ERROR_INVALID_PARAMETER

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Windns.h

Library

Dnsapi.lib

DLL

Dnsapi.dll

See also

DNS Functions

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.