multitype_join::consume Method

Consumes a message previously offered by the multitype_join messaging block and successfully reserved by the target, transferring ownership to the caller.

virtual message<_Destination_type> * consume(
   runtime_object_identity _MsgId,
   ITarget<_Destination_type> * _PTarget
);

Parameters

• _MsgId
  The runtime_object_identity of the reserved message object.

• _PTarget
  A pointer to the target block that is calling the consume method.

Return Value

A pointer to the message object that the caller now has ownership of.

Remarks

The consume method is similar to accept, but must always be preceded by a call to reserve that returned true.

Requirements

Header: agents.h

Namespace: Concurrency

See Also

Reference

multitype_join Class