Product SiteDocumentation Site

8.52. SysPulseEventSem (Windows only)


>>-SysPulseEventSem(handle)------------------------------------><

Posts and immediately resets an event semaphore. It sets the state of the event to signaled (available), releases any waiting threads, and resets it to nonsignaled (unavailable) automatically. If the event is manual, all waiting threads are released, the event is set to nonsignaled, and PulseEvent returns. If the event is automatic, a single thread is released, the event is set to nonsignaled, and PulseEvent returns. If no threads are waiting, or no threads can be released immediately, PulseEvent sets the state of the event to nonsignaled and returns.
SysPulseEventSem returns 0 on success and a Windows System Error code (Section 8.1, “A Note on Error Codes”) is returned on error. .
Parameter:
handle
The handle of an event semaphore previously created by SysCreateEventSem.