Partilhar via


Método source_block::consume

Consome uma mensagem oferecida anteriormente por esse objeto de source_block e reservada com êxito pelo destino, transferindo propriedade ao chamador.

virtual message<_Target_type> * consume(
   runtime_object_identity _MsgId,
   _Inout_ ITarget<_Target_type> * _PTarget
);

Parâmetros

  • _MsgId
    runtime_object_identity do objeto de message reservado.

  • _PTarget
    Um ponteiro para o bloco de destino que está chamando o método de consume .

Valor de retorno

Um ponteiro para o objeto de message que o chamador tem agora a propriedade de.

Comentários

O método gerará uma exceção de invalid_argument se o parâmetro _PTarget é NULL.

O método gerará uma exceção de bad_target se o parâmetro não _PTarget representa o destino que chamou reserve.

O método de consume é semelhante a accept, mas sempre deve ser precedido por uma chamada a reserve que retornou true.

Requisitos

Cabeçalho: agents.h

Namespace: simultaneidade

Consulte também

Referência

Classe source_block