CXI-Basis-Programmierreferenz / Version 2 / Datenaustausch / Ebene 2 / CxiMessageHandlerWithQueue /
long int CxiMessageHandlerWithQueue :: ExecuteQueueUntilEmpty ()
Bearbeitet alle Meldungen in der Queue
return:
immer 0
ExecuteQueueUntilEmpty 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 die Queue leer ist.
Ist die Queue bereits leer, kehrt ExecuteQueueUntilEmpty sofort zurück; die Funktion wartet nicht auf Meldungen.
Achtung: ExecuteQueueUntilEmpty 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
ExecuteQueueUntilError - Meldungen abarbeiten bis Fehler
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