INtime SDK Help
RtResetEvent (iwin32x)
INtime SDK v7.1 > About INtime > Alternate APIs > iwin32 API > iwin32x API > RtResetEvent (iwin32x)

Sets the specified event object to the nonsignaled state.

BOOLEAN RtResetEvent(
    HANDLE hEvent


Handle to the event object. RtCreateEvent returns this handle.


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

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


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


See Also

RtCreateEvent, iwin32x API, iwin32 Overview