message 类

项目
10/17/2023

包含正在消息块之间传递的数据负载的基本消息信封。

语法

template<class T>
class message : public ::Concurrency::details::_Runtime_object;

参数

T
消息中有效负载的数据类型。

成员

公共 Typedef

名称	描述
`type`	`T` 的类型别名。

公共构造函数

名称	描述
message	已重载。构造 `message` 对象。
~message 析构函数	销毁 `message` 对象。

公共方法

名称	描述
add_ref	添加到对象的 `message` 引用计数中。用于需要引用计数以确定消息生存期的消息块。
msg_id	返回 `message` 对象的 ID。
remove_ref	从 `message` 对象的引用计数中减去。用于需要引用计数以确定消息生存期的消息块。

公共数据成员

“属性”	描述
payload	`message` 对象的有效负载。

注解

有关详细信息，请参阅异步消息块。

继承层次结构

message

要求

标头： agents.h

命名空间： 并发

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。

_Msg
message 对象的引用或指针。

备注

将指向 message 对象的指针作为参数的构造函数，如果参数 _Msg 为 NULL，则会引发 invalid_argument 异常。

~message

销毁 message 对象。

virtual ~message();

msg_id

返回 message 对象的 ID。

runtime_object_identity msg_id() const;

返回值

runtime_object_identity 对象的 message。

payload

message 对象的有效负载。

T const payload;

remove_ref

从 message 对象的引用计数中减去。用于需要引用计数以确定消息生存期的消息块。

long remove_ref();

返回值