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 Devolução

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 Devolução

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 Devolução

O novo valor da contagem de referências.

Confira também

Namespace de simultaneidade