WSAResetEvent 函数 (winsock2.h)

WSAResetEvent 函数将指定事件对象的状态重置为不对齐。

语法

BOOL WSAAPI WSAResetEvent(
  [in] WSAEVENT hEvent
);

参数

[in] hEvent

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

返回值

如果 WSAResetEvent 函数成功,则返回值为 TRUE。 如果函数失败,则返回值为 FALSE。 若要获取扩展错误信息,请调用 WSAGetLastError

错误代码 含义
WSANOTINITIALIZED
在使用此函数之前,必须成功调用 WSAStartup
WSAENETDOWN
网络子系统发生故障。
WSAEINPROGRESS
阻止 Windows 套接字 1.1 调用正在进行,或者服务提供商仍在处理回调函数。
WSA_INVALID_HANDLE
hEvent 参数不是有效的事件对象句柄。

注解

WSAResetEvent 函数用于将事件对象的状态设置为非签名。

重置与 WSAEventSelect 函数一起使用的事件对象的状态的正确方法是将事件对象的句柄传递到 hEventObject 参数中的 WSAEnumNetworkEvents 函数。 这将重置事件对象,并以原子方式调整套接字上活动 FD 事件的状态。

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

另请参阅

WSACloseEvent

WSACreateEvent

WSAEnumNetworkEvents

WSAEventSelect

WSASetEvent

Winsock 函数

Winsock 参考