resetEvent 函数 (synchapi.h)
将指定的事件对象设置为非对齐状态。
语法
BOOL ResetEvent(
[in] HANDLE hEvent
);
参数
[in] hEvent
事件对象的句柄。 CreateEvent 或 OpenEvent 函数返回此句柄。
句柄必须具有EVENT_MODIFY_STATE访问权限。 有关详细信息,请参阅 Synchronization Object Security and Access Rights。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
在 SetEvent 或 PulseEvent 函数显式设置为发出信号之前,事件对象的状态将保持非对齐状态。 此非对齐状态会阻止在调用其中一个 wait 函数时指定事件对象的任何线程的执行。
ResetEvent 函数主要用于手动重置事件对象,必须将其显式设置为未签名状态。 释放单个等待线程后,自动重置事件对象会自动从已发出信号更改为非信号。
重置已重置的事件不起作用。
要求
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | synchapi.h (包括 Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2) |
Library | Kernel32.lib |
DLL | Kernel32.dll |