基本訊息封套,其中包含在傳訊區塊之間傳遞的資料承載。
語法
template<class T>
class message : public ::Concurrency::details::_Runtime_object;
參數
T
訊息中承載的數據類型。
成員
公用 Typedefs
| 名稱 | 描述 |
|---|---|
type |
的類型 T別名。 |
公用建構函式
| 名稱 | 描述 |
|---|---|
| message | 已多載。 建構 message 物件。 |
| ~message 解構函式 | message終結物件。 |
公用方法
| 名稱 | 描述 |
|---|---|
| add_ref | 加入至 對象的參考計數 message 。 用於需要參考計數以判斷訊息存留期的訊息區塊。 |
| msg_id | 傳回 物件的標識碼 message 。 |
| remove_ref | 從對象的參考計數 message 減去。 用於需要參考計數以判斷訊息存留期的訊息區塊。 |
公用資料成員
| 名稱 | 描述 |
|---|---|
| payload | 對象的承載 message 。 |
備註
如需詳細資訊,請參閱 異步消息塊。
繼承階層架構
message
需求
標頭: agents.h
命名空間: concurrency
add_ref
加入至 對象的參考計數 message 。 用於需要參考計數以判斷訊息存留期的訊息區塊。
long add_ref();
傳回值
參考計數的新值。
message
建構 message 物件。
message(
T const& _P);
message(
T const& _P,
runtime_object_identity _Id);
message(
message const& _Msg);
message(
_In_ message const* _Msg);
參數
_P
此訊息的承載。
_Id
這個訊息的唯一 ID。
_味精
對象的參考或指標 message 。
備註
如果 參數_Msg為 NULL,則接受 物件指標message作為自變數的建構函式會擲回invalid_argument例外狀況。
~消息
message終結物件。
virtual ~message();
msg_id
傳回 物件的標識碼 message 。
runtime_object_identity msg_id() const;
傳回值
runtime_object_identity message物件的 。
承載
對象的承載 message 。
T const payload;
remove_ref
從對象的參考計數 message 減去。 用於需要參考計數以判斷訊息存留期的訊息區塊。
long remove_ref();
傳回值
參考計數的新值。