source_block::reserve 方法
會保留先前由這個 source_block 物件所提供的訊息。
virtual bool reserve(
runtime_object_identity _MsgId,
_Inout_ ITarget<_Target_type> * _PTarget
);
參數
_MsgId
所提供之 message 物件的runtime_object_identity。_PTarget
正在呼叫 reserve 方法之目標區塊的指標。
傳回值
如果成功保留訊息則為 true,否則為false。 保留項目可能會失敗,有許多原因,包括: 郵件已保留或另一個目標,所接受的來源可以拒絕保留項目,等等。
備註
如果參數 _PTarget 是NULL,則此方法會擲回 invalid_argument 例外狀況。
呼叫 reserve之後 (若成功),您必須呼叫 consume 或 release,分別取得或放棄持有該訊息。
需求
標頭: agents.h
Namespace: 並行存取