CXI-Basis-Programmierreferenz / Version 2 / Datenaustausch / Ebene 1 /

~CxiMessageHandlerBase() - Destruktor

CxiMessageHandlerBase :: ~CxiMessageHandlerBase ()
CxiError CxiMessageHandlerBase :: WaitShutDown (void)

Destruktor für Meldungsempfänger

Der Meldungsempfänger wird gelöscht.

Bevor ein CxiMessageHandler...-Objekt gelöscht wird, sollte WaitShutDown() aufgerufen werden. Diese Funktion wartet, bis sich keine Meldungen mehr in Verarbeitung befinden, dann deaktiviert sie den Empfänger. Erst jetzt kann das Receiver-Objekt gefahrlos gelöscht werden. Um den expliziten Aufruf von WaitShutDown() zu vermeiden, sollte jeder Destruktor (sofern vorhanden) einer von CxiMessageHandlerBase abgeleiteten Klasse als erste (!) Aktion einen Aufruf von WaitShutDown() enthalten.

Programme können abstürzen, wenn der Aufruf von WaitShutDown im Destruktor einer Ableitung von CxiMessageHandler... vergessen wird und sich beim Löschen des Objekts gerade eine Meldung in Bearbeitung befindet.

Ein mehrfacher Aufruf von WaitShutDown() für dasselbe Objekt ist gefahrlos möglich.

Der Aufruf von WaitShutDown() ist nicht notwendig, wenn anderweitig sichergestellt wird, dass sich beim Löschen des Empfängers keine Meldung in Bearbeitung befindet (z.B. mit QueryReceiverState).

Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar.

Weitere Memberfunktionen:
CxiMessageHandlerBase(const char*) - Konstruktor
IsInHandler - Ist der Handler aktiv?
QueryReceiverState - Aktivierungsstatus
RequestShutDown - Herunterfahren eines Empfängers
CreateLocalAlias - Lokaler Aliasname
WaitState - Wartezustand
Handler1 - Bearbeitungsfunktion

Geerbte Memberfunktionen:
Status - Statusabfrage
IsValid - Ist Objekt gültig?
IsLocal - Ist Objekt lokal?
CountChildren - Anzahl untergeordneter Objekte
QueryIdent - Abfrage des Namens
QueryIdentAbs - Abfrage des absoluten Namens

Globale Funktionen:
PostMessageBlock - Versenden einer Meldung ohne Warten
SendMessageBlock - Versenden einer Meldung mit Warten
CreateGlobalAlias - Globaler Aliasname

Siehe auch:
Klassenhierarchie Meldungssystem
class CxiMessageIdent - Adresse eines Meldungsempfängers
class CxiMessageHandlerBase - Meldungsempfänger Ebene 1
class CxiMessageHandler - Erweiterter Meldungsempfänger
class CxiMessageHandlerWithQueue - Erweiterter Meldungsempfänger mit Queue