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.