setEvent 函数 (synchapi.h)

将指定的事件对象设置为信号状态。

语法

BOOL SetEvent(
  [in] HANDLE hEvent
);

[in] hEvent

事件对象的句柄。 CreateEvent 或 OpenEvent 函数返回此句柄。

句柄必须具有EVENT_MODIFY_STATE访问权限。有关详细信息，请参阅 Synchronization Object Security and Access Rights。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

手动重置事件对象的状态将保持信号状态，直到 ResetEvent 函数将其显式设置为非信号状态。在发出对象的状态信号时，可以释放任意数量的等待线程或随后通过调用一个等待函数开始对指定事件对象执行等待操作的线程。

相反， 自动重置 事件对象的状态将保持信号状态，直到释放单个等待线程，此时系统会自动将状态设置为未签名。如果没有线程在等待，则事件对象的状态将保持已发信号状态。

设置已设置的事件不起作用。

Windows 应用商店应用可以响应命名事件和信号灯，如如何响应命名事件和信号灯中所述。

有关使用 SetEvent 的示例，请参阅使用事件对象。

要求	值
最低受支持的客户端	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