包含正在消息块之间传递的数据负载的基本消息信封。
语法
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();
返回值
引用计数的新值。