WSACloseEvent 函数 (winsock2.h)

WSACloseEvent 函数关闭打开的事件对象句柄。

语法

BOOL WSAAPI WSACloseEvent(
  [in] WSAEVENT hEvent
);

[in] hEvent

标识打开事件的对象句柄。

如果函数成功，则返回值为 TRUE。

如果函数失败，则返回值为 FALSE。若要获取扩展的错误信息，请调用 WSAGetLastError。

错误代码	含义
WSANOTINITIALISED	在使用此函数之前，必须成功调用 WSAStartup 。
WSAENETDOWN	网络子系统失败。
WSAEINPROGRESS	阻止 Windows Sockets 1.1 调用正在进行，或者服务提供程序仍在处理回调函数。
WSA_INVALID_HANDLE	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