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 完成之前有效。