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

另请参阅

GetAddrInfoEx