INtime SDK Help
RtPulseEvent (iwin32x)
INtime SDK v7 > About INtime > Alternate APIs > iwin32 API > iwin32x API > RtPulseEvent (iwin32x)

For a manual-reset event object, all waiting threads that can be released immediately are released. The function then resets the event object's state to nonsignaled and returns.

For an auto-reset event object, the function resets the state to nonsignaled and returns after releasing a single waiting thread, even if multiple threads are waiting.

If no threads are waiting, or if no thread can be released immediately, PulseEvent simply sets the event object's state to nonsignaled and returns.

BOOLEAN RtPulseEvent(
    HANDLE hEvent
);

Parameters

hEvent
Handle to the event object. RtCreateEvent returns this handle.

Remarks

Action differs, depending upon the object:

Return Values

Non-zero
Success.
0 (zero)
Failure. For extended error information, see the Windows' GetLastError function.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/nt/include/iwin32x.h iwin32x.h iwin32x.lib

Notes

See Also

RtCreateEvent, iwin32x API, iwin32 Overview