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

Notes

• This function operates in the Windows portion of your application.
• The iwin32 API also includes an RtResetEvent function that operates in the real-time portion of your application.

See Also

RtCreateEvent, iwin32x API, iwin32 Overview