try_wait_eventtry_wait_eventTryWaitEventTryWaitEvent (Operator)

Name

try_wait_eventtry_wait_eventTryWaitEventTryWaitEvent — Lock an event synchronization object only if it is unlocked.

Signature

Description

try_wait_eventtry_wait_eventTryWaitEventTryWaitEventTryWaitEvent behaves identically to wait_eventwait_eventWaitEventWaitEventWaitEvent, except that it does not block the calling thread when waiting until the object is signaled but returns immediately. The state of the event before entering try_wait_eventtry_wait_eventTryWaitEventTryWaitEventTryWaitEvent is returned in BusyBusyBusyBusybusy. 1 indicates that the event was nonsignaled before calling try_wait_eventtry_wait_eventTryWaitEventTryWaitEventTryWaitEvent, 0 that the event was signaled.

Execution Information

• 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 try_wait_eventtry_wait_eventTryWaitEventTryWaitEventTryWaitEvent returns 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

create_eventcreate_eventCreateEventCreateEventCreateEvent

Possible Successors

signal_eventsignal_eventSignalEventSignalEventSignalEvent

See also

wait_eventwait_eventWaitEventWaitEventWaitEvent

Module

Foundation