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 |