dnsValidateServerStatus 函数 (windns.h)

DnsValidateServerStatus 函数将 IP 地址验证为合适的 DNS 服务器。

语法

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

参数

[in] server

指向包含要检查的 DNS 服务器 IPv4 或 IPv6 地址 的 SOCKADDR 的指针。

[in] queryName

指向 Unicode 字符串的指针,该字符串表示查询的记录集所有者 (FQDN) 完全限定的域名。

[out] serverStatus

指向表示查询验证状态的 DWORD 的指针。

含义
ERROR_SUCCESS
无错误。 调用成功。
DNS_VALSVR_ERROR_INVALID_ADDR
服务器 IP 地址无效。
DNS_VALSVR_ERROR_INVALID_NAME
queryName FQDN 无效。
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
在验证系统使用 UDP 对 DNS 服务器成功完成查询后,TCP 查询未返回ERROR_SUCCESS。
DNS_VALSVR_ERROR_UNKNOWN
出现未知错误。

返回值

DnsValidateServerStatus 函数具有以下可能的返回值:

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 windns.h
Library Dnsapi.lib
DLL Dnsapi.dll

另请参阅

DNS 函数