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 |