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