Compartilhar via


Classe de Mensagem

O envelope de mensagem básico que contém o pacote de dados que está sendo passado entre blocos de mensagens.

Sintaxe

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

Parâmetros

T
O tipo de dados da carga útil dentro da mensagem.

Membros

Typedefs públicos

Nome Descrição
type Um apelido de tipo para T.

Construtores públicos

Nome Descrição
message Sobrecarregado. Constrói um objeto message.
~message Destrutor Destrói o objeto message.

Métodos públicos

Nome Descrição
add_ref Adiciona à contagem de referência do objeto message. Usado para blocos de mensagens que precisam de contagem de referências para determinar o tempo de vida da mensagem.
msg_id Retorna a ID do objeto message.
remove_ref Reduz a contagem de referência do objeto message. Usado para blocos de mensagens que precisam de contagem de referências para determinar o tempo de vida da mensagem.

Membros de Dados Públicos

Nome Descrição
payload A carga do objeto message.

Comentários

Para mais informações, confira Blocos de mensagens assíncronas.

Hierarquia de herança

message

Requisitos

Cabeçalho: agents.h

Namespace: simultaneidade

adicionar_referência

Adiciona à contagem de referência do objeto message. Usado para blocos de mensagens que precisam de contagem de referências para determinar o tempo de vida da mensagem.

long add_ref();

Valor de retorno

O novo valor da contagem de referências.

mensagem

Constrói um objeto message.

message(
    T const& _P);

message(
    T const& _P,
    runtime_object_identity _Id);

message(
    message const& _Msg);

message(
    _In_ message const* _Msg);

Parâmetros

_P
O conteúdo desta mensagem.

_Id
O ID exclusivo desta mensagem.

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

Comentários

O construtor que recebe um ponteiro para um objeto message como argumento lança uma exceção invalid_argument se o parâmetro _Msg for NULL.

~Mensagem

Destrói o objeto message.

virtual ~message();

msg_id

Retorna a ID do objeto message.

runtime_object_identity msg_id() const;

Valor de retorno

O runtime_object_identity do objeto message.

conteúdo

A carga do objeto message.

T const payload;

remove_ref

Reduz a contagem de referência do objeto message. Usado para blocos de mensagens que precisam de contagem de referências para determinar o tempo de vida da mensagem.

long remove_ref();

Valor de retorno

O novo valor da contagem de referências.

Confira também

Namespace de concorrência