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

另請參閱

CreateEvent

事件物件

OpenEvent

ResetEvent

SetEvent

同步處理函式