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

関連項目

DNS 関数