WSACloseEvent 函数 (winsock2.h)
WSACloseEvent 函数关闭打开的事件对象句柄。
语法
BOOL WSAAPI WSACloseEvent(
[in] WSAEVENT hEvent
);
参数
[in] hEvent
标识打开事件的对象句柄。
返回值
如果函数成功,则返回值为 TRUE。
如果函数失败,则返回值为 FALSE。 若要获取扩展的错误信息,请调用 WSAGetLastError。
错误代码 | 含义 |
---|---|
在使用此函数之前,必须成功调用 WSAStartup 。 | |
网络子系统失败。 | |
阻止 Windows Sockets 1.1 调用正在进行,或者服务提供程序仍在处理回调函数。 | |
hEvent 不是有效的事件对象句柄。 |
注解
WSACloseEvent 函数关闭事件对象的句柄,并释放与事件对象关联的资源。 此函数用于关闭 由 WSACreateEvent 函数创建的句柄。 关闭事件对象的句柄后,对此句柄的进一步引用将失败, 并WSA_INVALID_HANDLE错误。
Windows Phone 8:Windows Phone 8 及更高版本上的 Windows Phone 应用商店应用支持此函数。
Windows 8.1和Windows Server 2012 R2:Windows 8.1、Windows Server 2012 R2 及更高版本的 Windows 应用商店应用支持此函数。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8.1、Windows Vista [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | winsock2.h |
Library | Ws2_32.lib |
DLL | Ws2_32.dll |