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

クエリを実行するレコードセットの所有者の完全修飾ドメイン名 (FQDN) を表す Unicode 文字列へのポインター。

[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