target_block::send Method

target_block::send Method


Synchronously passes a message from a source block to this target block.

virtual message_status send(
   _Inout_ message<_Source_type> * _PMessage,
   _Inout_ ISource<_Source_type> * _PSource


A pointer to the message object.


A pointer to the source block offering the message.

A message_status indication of what the target decided to do with the message.

The method throws an invalid_argument exception if either the _PMessage or _PSource parameter is NULL.

Using the send method outside of message initiation and to propagate messages within a network is dangerous and can lead to deadlock.

When send returns, the message has either already been accepted, and transferred into the target block, or it has been declined by the target.


Header: agents.h

Namespace: concurrency

© 2016 Microsoft