Compartilhar via


Classe message

O envelope de mensagem básico que contém a carga de dados sendo passada entre blocos de mensagens.

Sintaxe

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

Parâmetros

T
O tipo de dados do conteúdo dentro da mensagem.

Membros

Typedefs públicos

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

Construtores públicos

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

Métodos públicos

Nome Descrição
add_ref Adiciona à contagem de referência para o 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 Subtrai da contagem de referência para o 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: concurrency

add_ref

Adiciona à contagem de referência para o 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
A ID exclusiva desta mensagem.

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

Comentários

O construtor que leva um ponteiro para um objeto message como um argumento gera 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.

payload

A carga do objeto message.

T const payload;

remove_ref

Subtrai da contagem de referência para o 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 simultaneidade