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.1Windows 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

另请参阅

WSACreateEvent

WSAEnumNetworkEvents

WSAEventSelect

WSAGetOverlappedResult

WSARecv

WSARecvFrom

WSAResetEvent

WSASend

WSASendTo

WSASetEvent

WSAWaitForMultipleEvents

Winsock 函数

Winsock 参考