clear_eventclear_eventClearEventclear_eventClearEventClearEvent (Operator)

Name

clear_eventclear_eventClearEventclear_eventClearEventClearEvent — Clear the event synchronization object.

Signature

Description

clear_eventclear_eventClearEventclear_eventClearEventClearEvent destroys the mutex object given by EventHandleEventHandleEventHandleEventHandleEventHandleeventHandle. No threads should be waiting on the event at the time clear_eventclear_eventClearEventclear_eventClearEventClearEvent is called. After calling clear_eventclear_eventClearEventclear_eventClearEventClearEvent, the event can no longer be used. The handle EventHandleEventHandleEventHandleEventHandleEventHandleeventHandle becomes invalid.

Parallelization

• Multithreading type: independent (runs in parallel even with exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

If the event handle is valid, the operator clear_eventclear_eventClearEventclear_eventClearEventClearEvent returns 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

create_eventcreate_eventCreateEventcreate_eventCreateEventCreateEvent

See also

create_eventcreate_eventCreateEventcreate_eventCreateEventCreateEvent, clear_all_eventsclear_all_eventsClearAllEventsclear_all_eventsClearAllEventsClearAllEvents

Module

Foundation