Функция DnsValidateServerStatus (windns.h)

Функция DnsValidateServerStatus проверяет IP-адрес в качестве подходящего DNS-сервера.

Синтаксис

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

[in] server

Указатель на SOCKADDR , содержащий IPv4- или IPv6-адрес DNS-сервера для проверки.

[in] queryName

Указатель на строку Юникода, представляющую полное доменное имя владельца запрашиваемого набора записей.

[out] serverStatus

Указатель на DWORD, представляющий состояние проверки запроса.

Значение	Значение
ERROR_SUCCESS	Ошибок нет. Вызов выполнен успешно.
DNS_VALSVR_ERROR_INVALID_ADDR	Сервера НЕДОПУСТИМЫй IP-адрес.
DNS_VALSVR_ERROR_INVALID_NAME	queryName Полное доменное имя было недопустимым.
DNS_VALSVR_ERROR_UNREACHABLE	DNS-сервер был недостижим.
DNS_VALSVR_ERROR_NO_RESPONSE	Время ожидания ответа DNS-сервера.
DNS_VALSVR_ERROR_NO_AUTH	DNS-сервер не является полномочным или queryName не найден.
DNS_VALSVR_ERROR_REFUSED	DNS-сервер отклонил запрос.
DNS_VALSVR_ERROR_NO_TCP	TCP-запрос не вернул ERROR_SUCCESS после того, как система проверки уже успешно выполнила запрос к DNS-серверу с использованием UDP.
DNS_VALSVR_ERROR_UNKNOWN	Произошла неизвестная ошибка.

Функция DnsValidateServerStatus имеет следующие возможные возвращаемые значения:


Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	windns.h
Библиотека	Dnsapi.lib
DLL	Dnsapi.dll