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

PollQueue - Eine Meldung abarbeiten

long int CxiMessageHandlerWithQueue :: PollQueue ()

Bearbeitet die nächste Meldung in der Queue

return:
Rückgabewert der Behandlungsfunktion, 0 bei leerer Queue

PollQueue prüft, ob eine Meldung in der Queue vorliegt. Ist eine solche vorhanden, wird sie aus der Queue genommen und der Handlerfunktion übergeben. Dies führt zu einem rekursiven Aufruf des Handlers! Nach der Abarbeitung durch den Handler2 kehrt PollQueue zurück.

Ist die Queue leer, kehrt PollQueue sofort zurück; die Funktion wartet nicht auf eine Meldung.

Achtung: PollQueue prüft 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
ExecuteQueueUntilEmpty - Alle Meldungen 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