source_block::consume 方法
會將擁有權轉移至呼叫端,使用此 source_block 物件先前提供並由目標成功保留的訊息。
virtual message<_Target_type> * consume(
runtime_object_identity _MsgId,
_Inout_ ITarget<_Target_type> * _PTarget
);
參數
_MsgId
所保留之 message 物件的runtime_object_identity。_PTarget
正在呼叫 consume 方法之目標區塊的指標。
傳回值
message 物件的指標,此物件的擁有權目前為呼叫端所有。
備註
如果參數 _PTarget 是NULL,則此方法會擲回 invalid_argument 例外狀況。
如果參數 不代表稱為 的目標,則此方法會擲回 _PTarget bad_target reserve 例外狀況。
consume 方法類似於 accept,但前面必須永遠加上對 reserve 的呼叫 (此呼叫傳回 true)。
需求
標頭: agents.h
Namespace: 並行存取