Condividi tramite


Classe di messaggio

Busta del messaggio di base contenente il payload dei dati passati tra blocchi della messaggistica.

Sintassi

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

Parametri

T
Tipo di dati del payload all'interno del messaggio.

Membri

Typedef pubblici

Nome Descrizione
type Alias di tipo per T.

Costruttori pubblici

Nome Descrizione
message Sovraccarico. Costruisce un oggetto message.
~message Distruttore Elimina definitivamente l'oggetto message .

Metodi pubblici

Nome Descrizione
add_ref Aggiunge al conteggio dei riferimenti per l'oggetto message . Usato per i blocchi di messaggi che richiedono il conteggio dei riferimenti per determinare la durata dei messaggi.
msg_id Restituisce l'ID dell'oggetto message .
remove_ref Sottrae dal conteggio dei riferimenti per l'oggetto message . Usato per i blocchi di messaggi che richiedono il conteggio dei riferimenti per determinare la durata dei messaggi.

Membri di dati pubblici

Nome Descrizione
payload Il carico utile dell'oggetto message.

Osservazioni:

Per altre informazioni, vedere Blocchi di messaggi asincroni.

Gerarchia di ereditarietà

message

Requisiti

Intestazione: agents.h

Spazio dei nomi: Concurrency

aggiungi_riferimento

Aggiunge al conteggio dei riferimenti per l'oggetto message . Usato per i blocchi di messaggi che richiedono il conteggio dei riferimenti per determinare la durata dei messaggi.

long add_ref();

Valore restituito

Nuovo valore del conteggio dei riferimenti.

messaggio

Costruisce un oggetto message.

message(
    T const& _P);

message(
    T const& _P,
    runtime_object_identity _Id);

message(
    message const& _Msg);

message(
    _In_ message const* _Msg);

Parametri

_P
Contenuto del payload del messaggio.

_Id
ID univoco di questo messaggio.

_Msg
Riferimento o puntatore a un message oggetto .

Osservazioni:

Il costruttore che accetta un puntatore a un message oggetto come argomento genera un'eccezione invalid_argument se il parametro _Msg è NULL.

~Messaggio

Elimina definitivamente l'oggetto message .

virtual ~message();

msg_id

Restituisce l'ID dell'oggetto message .

runtime_object_identity msg_id() const;

Valore restituito

runtime_object_identity dell'oggetto message.

carico utile

Il carico utile dell'oggetto message.

T const payload;

rimuovi_ref

Sottrae dal conteggio dei riferimenti per l'oggetto message . Usato per i blocchi di messaggi che richiedono il conteggio dei riferimenti per determinare la durata dei messaggi.

long remove_ref();

Valore restituito

Nuovo valore del conteggio dei riferimenti.

Vedi anche

Spazio dei nomi concorrenza