clear_barrierT_clear_barrierClearBarrierClearBarrier (Operator)

Name

clear_barrierT_clear_barrierClearBarrierClearBarrier — Destroy a barrier synchronization object.

Signature

clear_barrier( : : BarrierHandle : )

Herror T_clear_barrier(const Htuple BarrierHandle)

void ClearBarrier(const HTuple& BarrierHandle)

void HBarrier::ClearBarrier() const

static void HOperatorSet.ClearBarrier(HTuple barrierHandle)

void HBarrier.ClearBarrier()

Description

clear_barrierclear_barrierClearBarrierClearBarrierClearBarrier destroys the barrier object given in BarrierHandleBarrierHandleBarrierHandleBarrierHandlebarrierHandle. No threads should be waiting on the barrier at the time clear_barrierclear_barrierClearBarrierClearBarrierClearBarrier is called. After calling clear_barrierclear_barrierClearBarrierClearBarrierClearBarrier, the barrier can no longer be used. The handle BarrierHandleBarrierHandleBarrierHandleBarrierHandlebarrierHandle becomes invalid.

Execution Information

This operator modifies the state of the following input parameter:

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

Parameters

BarrierHandleBarrierHandleBarrierHandleBarrierHandlebarrierHandle (input_control, state is modified)  barrier HBarrier, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Barrier synchronization object.

Result

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

Possible Predecessors

create_barriercreate_barrierCreateBarrierCreateBarrierCreateBarrier

See also

create_barriercreate_barrierCreateBarrierCreateBarrierCreateBarrier

Module

Foundation