PulseEvent 函式 (winbase.h)
將指定的事件物件設定為已發出訊號的狀態，然後在釋放適當的等候線程數目之後，將其重設為非簽署狀態。
語法
BOOL PulseEvent(
[in] HANDLE hEvent
);
參數
[in] hEvent
事件物件的句柄。 CreateEvent 或 OpenEvent 函式會傳回此句柄。
句柄必須具有EVENT_MODIFY_STATE訪問許可權。 如需詳細資訊，請參閱 同步處理物件安全性和訪問許可權。
傳回值
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
在同步處理物件上等候的線程可以暫時從核心模式 APC 的等候狀態中移除，然後在 APC 完成之後返回等候狀態。 如果在線程從等候狀態移除線程期間發生 對 PulseEvent 的呼叫，則不會釋放線程，因為 PulseEvent 只會釋放呼叫時正在等候的線程。 因此， PulseEvent 不可靠，而且不應該供新的應用程式使用。 請改用 條件變數。
針對手動重設事件物件，會立即釋放所有可立即釋放的等候線程。 然後函式會將事件物件的狀態重設為非簽署並傳回。
對於自動重設事件物件，函式會將狀態重設為未簽署，並在釋放單一等候線程之後傳回，即使有多個線程正在等候也一樣。
如果沒有線程正在等候，或者如果無法立即釋放任何線程， PulseEvent 只會將事件對象的狀態設定為非簽署並傳回。
請注意，對於使用多物件 等候函 式的線程等待所有指定的對象發出訊號， PulseEvent 可以將事件物件的狀態設定為已發出訊號，並將它重設為未簽署，而不會造成等候函式傳回。 如果並非所有指定的物件同時發出訊號，就會發生這種情況。
搭配 Windows 7 使用 SignalObjectAndWait 和 PulseEvent 時，請特別小心，因為在這些線程之間使用這些 API 可能會導致應用程式死結。 SignalObjectAndWait 發出訊號的線程會呼叫 PulseEvent，以向 SignalObjectAndWait 呼叫的等候對象發出訊號。 在某些情況下， SignalObjectAndWait 的呼叫端無法及時接收等候物件的訊號狀態，導致死結。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winbase.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |