次の方法で共有


DnsCancelQuery 関数 (windns.h)

DnsCancelQuery 関数を使用して、DNS 名前空間に対する保留中のクエリを取り消すことができます。

構文

DNS_STATUS DnsCancelQuery(
  [in] PDNS_QUERY_CANCEL pCancelHandle
);

パラメーター

[in] pCancelHandle

非同期 DNS クエリを取り消すために使用される DNS_QUERY_CANCEL 構造体へのポインター。 構造体は、DnsQueryEx への以前の呼び出しの pCancelHandle パラメーターで返されている必要があります。

戻り値

正常に完了すると、成功の確認が返されます。 それ以外の場合は、Winerror.h で定義されている適切な DNS 固有のエラー コードが返されます。

注釈

DnsCancelQuery は、 取り消す前にクエリの完了を待機しません。 そのため、アプリケーションは、 DNS_QUERY_COMPLETION_ROUTINE DNS コールバックを使用して保留中のクエリを追跡する必要があります。

pCancelHandle は、 DNS_QUERY_COMPLETION_ROUTINE DNS コールバックが呼び出され、 DnsCancelQuery が完了するまで有効です。

要件

要件
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー windns.h
Library Dnsapi.lib
[DLL] Dnsapi.dll

こちらもご覧ください

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_REQUEST

DNS_QUERY_RESULT

DnsQuery

DnsQueryEx