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

ExecuteQueueUntilError - Meldungen abarbeiten bis Fehler

long int CxiMessageHandlerWithQueue :: ExecuteQueueUntilError ()

Bearbeitet die Meldungen in der Queue, bis ein Fehler auftritt

return:
Rückgabe des letzten Aufrufs des Handlers

ExecuteQueueUntilError entnimmt in einer Schleife jeweils eine Meldung aus der Queue und übergibt sie der Handlerfunktion. Dies führt zu rekursiven Aufrufen des Handlers! Die Schleife wird solange fortgesetzt, bis der Handler2 einen Wert ungleich 0 zurückgibt oder die Queue leer ist.

Ist die Queue bereits leer, kehrt ExecuteQueueUntilError sofort zurück; die Funktion wartet nicht auf Meldungen.

Achtung: ExecuteQueueUntilError bearbeitet nur die eigene Queue. Werden Meldungen systembedingt auch außerhalb der Klasse CxiMessageHandlerWithQueue zwischengespeichert (z.B. bei OS/2), so werden diese nur von WaitState erkannt!

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

Weitere Memberfunktionen:
CxiMessageHandlerWithQueue(...) - Konstruktor
PreHandler - Abfangen von Meldungen
Handler2 - Bearbeitungsfunktion
WaitState - Wartezustand
CountQueue - Anzahl Meldungen in der Queue
PollQueue - Eine Meldung abarbeiten
ExecuteQueueUntilEmpty - Alle Meldungen abarbeiten
ZapQueue - Queue löschen
LockQueue - Automatisches Abarbeiten verhindern
UnLockQueue - Automatisches Abarbeiten ermöglichen
Post - Verschicken einer erweiterten Meldung
Pass - Weiterleiten einer empfangenen Meldung
IsInHandler - Ist der Handler aktiv?
QueryReceiverState - Aktivierungsstatus
RequestShutDown - Herunterfahren eines Empfängers