Sprung zum Seitenende Struktur Themen A...Z Titel << >>

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

QueryReceiverState - Aktivierungsstatus

[C++] CxiReceiverState CxiMessageHandlerBase :: QueryReceiverState (void)

[S2:STANDARD] Aktivierungsstatus des Empfängers

return:
siehe Text

QueryReceiverState liefert den aktuellen Empfangsstatus des Empfängers zurück. Es ist eine der folgenden Konstanten:

cxiReceiverStateInit:
Der Empfänger befindet sich in der Initialisierungsphase, er kann noch keine Meldungen entgegennehmen.

cxiReceiverStateWaiting:
Der Empfänger ist bereit zur Verarbeitung von Meldungen, es liegen jedoch keine Daten vor.

cxiReceiverStateExecuting:
Die Verarbeitung einer Meldung wird gerade vor- oder nachbereitet. Dies ist daher ein kurzfristiger Status.

cxiReceiverStateHandler:
Eine Meldung wird gerade von der Handler-Funktion verarbeitet. Dieser Status gilt auch, wenn über WaitState eine Rekursion auftreten sollte. Er wird erst verlassen, wenn KEINE Meldung mehr in Bearbeitung ist. Ist IsInHandler() == 1, so kann der Status cxiReceiverStateHandler nicht verlassen werden, ohne dass die aufrufende Funktion sich mit return beendet.

cxiReceiverStateTerminating:
Der Empfänger soll beendet werden (siehe RequestShutDown). Er ist gerade beim Herunterfahren. Es sollten keine Meldungen mehr an ihn geschickt werden, da diese verloren gehen könnten.

cxiReceiverStateShutDown:
Der Empfänger ist heruntergefahren und inaktiv. Er kann gefahrlos gelöscht werden.

cxiReceiverStateUnknown:
Es liegt ein Fehler oder ein unbekannter Status vor.

QueryReceiverState bezieht sich nur auf die interne Verarbeitung der CXI-Basisklassen (CxiMessageHandler...), nicht auf die Objekte selbst. Diese müssen anschließend normal gelöscht werden. Die Rückgabe cxiReceiverStateShutDown bedeutet, dass von CXI-Seite keine asynchronen Zugriffe auf das Objekt mehr erfolgen.

Portabilität:
Diese Funktion ist ab Version 2.07 definiert und in allen unterstützten Systemen verfügbar.

Weitere Memberfunktionen:
CxiMessageHandlerBase(const char*) - Konstruktor
~CxiMessageHandlerBase() - Destruktor
WaitShutDown - Warten auf Handler
IsInHandler - Ist der Handler aktiv?
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


[i] CXI-Basis-Programmierreferenz
Version 2.10 72 (1014-001), erstellt am 15. April 2000
Textseite 303 von 855, Thema 8512 (QueryReceiverState)
[c] Copyright (c) 1996-2000 by TeraConnect GmbH

Sprung zum Seitenanfang Struktur Themen A...Z Titel << >>