dnsValidateServerStatus 函式 (windns.h)

DnsValidateServerStatus函式會將 IP 位址驗證為適當的 DNS 伺服器。

語法

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

[in] server

SOCKADDR的指標，其中包含要檢查的 DNS 伺服器 IPv4 或 IPv6 位址。

[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函式具有下列可能的傳回值：