WSAResetEvent 函数 (winsock2.h)
WSAResetEvent 函数将指定事件对象的状态重置为不对齐。
语法
BOOL WSAAPI WSAResetEvent(
[in] WSAEVENT hEvent
);
参数
[in] hEvent
标识打开的事件对象句柄的句柄。
返回值
如果 WSAResetEvent 函数成功,则返回值为 TRUE。 如果函数失败,则返回值为 FALSE。 若要获取扩展错误信息,请调用 WSAGetLastError。
错误代码 | 含义 |
---|---|
在使用此函数之前,必须成功调用 WSAStartup 。 | |
网络子系统发生故障。 | |
阻止 Windows 套接字 1.1 调用正在进行,或者服务提供商仍在处理回调函数。 | |
hEvent 参数不是有效的事件对象句柄。 |
注解
WSAResetEvent 函数用于将事件对象的状态设置为非签名。
重置与 WSAEventSelect 函数一起使用的事件对象的状态的正确方法是将事件对象的句柄传递到 hEventObject 参数中的 WSAEnumNetworkEvents 函数。 这将重置事件对象,并以原子方式调整套接字上活动 FD 事件的状态。
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 |