Freigeben über


message-Klasse

Der grundlegende Nachrichtenumschlag, der die zwischen den Meldungsblöcken übergebene Datennutzlast enthält.

Syntax

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

Parameter

T
Der Datentyp der Nutzlast innerhalb der Nachricht.

Mitglieder

Öffentliche Typedefs

Name Beschreibung
type Ein Typalias für T.

Öffentliche Konstruktoren

Name Beschreibung
message Überladen. Erstellt ein message-Objekt.
Destruktor für ~message Zerstört das message-Objekt.

Öffentliche Methoden

Name Beschreibung
add_ref Fügt die Verweisanzahl für das Objekt message hinzu. Wird für Nachrichtenblöcke verwendet, die eine Referenzzählung benötigen, um die Lebensdauer von Nachrichten zu bestimmen.
msg_id Gibt die ID des message Objekts zurück.
remove_ref Subtrahiert von der Verweisanzahl für das Objekt message. Wird für Nachrichtenblöcke verwendet, bei denen eine Referenzzählung erforderlich ist, um die Lebensdauer der Nachrichten zu bestimmen.

Öffentliche Datenmitglieder

Name Beschreibung
payload Die Nutzlast des message Objekts.

Hinweise

Weitere Informationen finden Sie unter "Asynchrone Nachrichtenblöcke".

Vererbungshierarchie

message

Anforderungen

Header: agents.h

Namespace: Parallelität

add_ref

Fügt der Verweisanzahl für das message-Objekt hinzu. Wird für Nachrichtenblöcke verwendet, für die eine Referenzzählung erforderlich ist, um die Lebensdauer der Nachrichten zu bestimmen.

long add_ref();

Rückgabewert

Der neue Wert der Bezugsanzahl.

Nachricht

Erstellt ein message-Objekt.

message(
    T const& _P);

message(
    T const& _P,
    runtime_object_identity _Id);

message(
    message const& _Msg);

message(
    _In_ message const* _Msg);

Parameter

_P
Die Nutzlast dieser Nachricht.

_Id
Die eindeutige ID dieser Nachricht.

_Msg
Ein Verweis oder Zeiger auf ein message Objekt.

Hinweise

Der Konstruktor, der einen Zeiger auf ein message Objekt als Argument verwendet, löst eine invalid_argument Ausnahme aus, wenn der Parameter _Msg lautet NULL.

~Nachricht

Zerstört das message-Objekt.

virtual ~message();

msg_id

Gibt die ID des message Objekts zurück.

runtime_object_identity msg_id() const;

Rückgabewert

runtime_object_identity des message-Objekts.

Nutzlast

Die Nutzlast des message Objekts.

T const payload;

Entferne_Ref

Subtrahiert von der Verweisanzahl für das Objekt message. Wird für Nachrichtenblöcke verwendet, für die eine Referenzzählung erforderlich ist, um die Lebensdauer der Nachrichten zu bestimmen.

long remove_ref();

Rückgabewert

Der neue Wert der Bezugsanzahl.

Siehe auch

Concurrency-Namespace