Partilhar via


Classe de mensagem

O envelope básico da mensagem contendo a carga útil de dados a ser passada entre blocos de mensagens.

Sintaxe

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

Parâmetros

T
O tipo de dados do payload dentro da mensagem.

Membros

Definições de Tipos Públicas

Nome Description
type Um apelido de tipo para T.

Construtores Públicos

Nome Description
mensagem Sobrecarregado. Constrói um message objeto.
~mensagem Destruidora Destrói o message objeto.

Métodos Públicos

Nome Description
adicionar_referência Adiciona à contagem de referência do objeto message. Usado para blocos de mensagens que necessitam de contagem de referências para determinar a vida útil das mensagens.
msg_id Devolve o ID do message objeto.
remove_ref Subtrai da contagem de referência do objeto message. Usado para blocos de mensagens que necessitam de contagem de referências para determinar a vida útil das mensagens.

Membros de Dados Públicos

Nome Description
carga útil A carga útil do objeto message.

Observações

Para mais informações, consulte Blocos de Mensagens Assíncronas.

Hierarquia de herança

message

Requerimentos

Cabeçalho: agents.h

Namespace: simultaneidade

adicionar_referencia

Adiciona à contagem de referência do objeto message. Usado para blocos de mensagens que necessitam de contagem de referências para determinar a vida útil das mensagens.

long add_ref();

Valor de retorno

O novo valor da contagem de referência.

mensagem

Constrói um message objeto.

message(
    T const& _P);

message(
    T const& _P,
    runtime_object_identity _Id);

message(
    message const& _Msg);

message(
    _In_ message const* _Msg);

Parâmetros

_P
A carga útil desta mensagem.

_Id
O ID único desta mensagem.

_Msg
Uma referência ou apontador para um message objeto.

Observações

O construtor que recebe um ponteiro para um objeto como argumento lança uma exceção de argumento inválido se o parâmetro for .

~mensagem

Destrói o message objeto.

virtual ~message();

msg_id

Devolve o ID do message objeto.

runtime_object_identity msg_id() const;

Valor de retorno

O runtime_object_identity do message objeto.

payload

A carga útil do objeto message.

T const payload;

remove_ref

Subtrai à contagem de referência para o objeto message. Usado para blocos de mensagens que necessitam de contagem de referências para determinar a vida útil das mensagens.

long remove_ref();

Valor de retorno

O novo valor da contagem de referência.

Consulte também

concorrência Namespace