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.

Member

Öffentliche Typedefs

Name	Beschreibung
type	Ein Typalias für T.

Öffentliche Konstruktoren

Name	Beschreibung
message	Überladen. Erstellt ein message-Objekt.
~message Destructor	Zerstört das message-Objekt.

Öffentliche Methoden

Name	Beschreibung
add_ref	Fügt der Verweisanzahl für das message Objekt hinzu. Wird für Nachrichtenblöcke verwendet, die referenziert werden müssen, 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 message Objekt. Wird für Nachrichtenblöcke verwendet, die referenziert werden müssen, um die Lebensdauer von Nachrichten zu bestimmen.

Öffentliche Datenmember

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, die referenziert werden müssen, um die Lebensdauer von Nachrichten zu bestimmen.

long add_ref();

Rückgabewert

Der neue Wert der Bezugsanzahl.

message

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.

payload

Die Nutzlast des message Objekts.

T const payload;

remove_ref

Subtrahiert von der Verweisanzahl für das message Objekt. Wird für Nachrichtenblöcke verwendet, die referenziert werden müssen, um die Lebensdauer von Nachrichten zu bestimmen.

long remove_ref();

Rückgabewert

Der neue Wert der Bezugsanzahl.

Siehe auch

Concurrency-Namespace