GetAddrInfoExCancel 函数 (ws2tcpip.h)
GetAddrInfoExCancel 函数取消 GetAddrInfoEx 函数的异步操作。
语法
INT WSAAPI GetAddrInfoExCancel(
[in] LPHANDLE lpHandle
);
参数
[in] lpHandle
要取消的异步操作的句柄。 这是 GetAddrInfoEx 函数在 lpNameHandle 参数中返回的句柄。
返回值
成功后， GetAddrInfoExCancel 返回 NO_ERROR (0) 。 失败将返回非零 Windows 套接字错误代码，如 Windows 套接字错误代码中所示。
注解
GetAddrInfoExCancel 函数取消异步 GetAddrInfoEx 操作。 结果是立即调用用户的完成机制（回调或事件）。 不返回任何结果，并且为 GetAddrInfoEx 异步操作返回的错误代码设置为 WSA_E_CANCELLED。 如果 GetAddrInfoEx 请求已完成或超时，或者句柄无效， WSA_INVALID_HANDLE 将由 GetAddrInfoExCancel 函数返回。
由于许多基础操作 (旧名称服务提供程序（例如，) ）是同步的，因此实际上不会取消这些操作。 这些操作将继续运行并消耗资源。 完成最后一个未完成名称服务提供商请求后，将释放资源。
Windows 8.1和Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更高版本的 Windows 应用商店应用支持此函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8.1、Windows 8 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2012 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | ws2tcpip.h |
| Library | Ws2_32.lib |
| DLL | Ws2_32.dll |