INtime SDK Help
RtResetEvent (iwin32x)
INtime SDK v6 > About INtime > Alternate APIs > iwin32 API > iwin32x API > RtResetEvent (iwin32x)

Sets the specified event object to the nonsignaled state.

BOOLEAN RtResetEvent(
    HANDLE hEvent
);

Parameters

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

Remarks

RtSetEvent can also be used from a Windows application to set an iwin32 event.

The state of a manual-reset event object remains signaled until set explicitly to the nonsignaled state by RtResetEvent. Any number of waiting threads, or threads that subsequently begin wait operations for the specified event object by calling a wait function; can be released while the object's state is signaled.

The state of an auto-reset event object remains signaled until a single waiting thread is released, at which time the system automatically sets the state to nonsignaled. If no threads are waiting, the event object's state remains signaled.

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