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

PreHandler - Abfangen von Meldungen

protected: virtual int CxiMessageHandlerWithQueue :: PreHandler (CxiHandle msghandle)

Fängt eine Meldung vor Einstellung in die Queue ab

msghandle:
Handle der Meldung

return:
1: Meldung in die Queue aufnehmen
0: Meldung nicht in die Queue aufnehmen

Diese Funktion wird immer dann aufgerufen, wenn die Klasse CxiMessageHandlerWithQueue eine Meldung empfängt und diese in die Queue aufnehmen will. Durch Überschreiben von PreHandler kann eine Vorauswahl der Meldungen getroffen werden, um eine übermäßige Belastung der Queue zu verhindern oder wichtige Mitteilungen sofort bearbeiten zu können.

Wichtig: Der Aufruf von PreHandler wird nicht mit der normalen Verarbeitung von Meldungen synchronisiert. Rekursive Aufrufe sind möglich. PreHandler muss daher reentrant programmiert werden.

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

Weitere Memberfunktionen:
CxiMessageHandlerWithQueue(...) - Konstruktor
Handler2 - Bearbeitungsfunktion
WaitState - Wartezustand
CountQueue - Anzahl Meldungen in der Queue
PollQueue - Eine Meldung abarbeiten
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