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 |
| 程式庫 | Dnsapi.lib |
| Dll | Dnsapi.dll |