clear_eventT_clear_eventClearEventClearEventclear_event (Operator)

Name

clear_eventT_clear_eventClearEventClearEventclear_event — Clear the event synchronization object.

Signature

Description

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

Execution Information

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

This operator modifies the state of the following input parameter:

• EventHandleEventHandleEventHandleEventHandleeventHandleevent_handle

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

Result

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

Possible Predecessors

create_eventcreate_eventCreateEventCreateEventCreateEventcreate_event

See also

create_eventcreate_eventCreateEventCreateEventCreateEventcreate_event

Module

Foundation