message 類別

發行項
10/12/2023

基本訊息封套，其中包含在傳訊區塊之間傳遞的資料承載。

語法

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` 減去。用於需要參考計數以判斷訊息存留期的訊息區塊。

公用資料成員

名稱	描述
負載	物件的承載 `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_identitymessage 物件的。

負載

物件的承載 message 。

T const payload;

remove_ref

從物件的參考計數 message 減去。用於需要參考計數以判斷訊息存留期的訊息區塊。

long remove_ref();

傳回值