CXI-Basis-Programmierreferenz / Version 2 / Datenaustausch / Ebene 2 / Message Queue /

PostMessageTreeOptions - Globale Queue aktivieren

static CxiLong CXIB :: PostMessageTreeOptions (CxiLong set = 0, CxiLong reset = 0)
CxiLong cxiSetExtendedPostOptions (CxiLong set, CxiLong reset)

Aktiviert die automatische Umleitung von Meldungen über die globale Queue

set:
zu setzende Standardoptionen (cxiOptPostMsgForceQueue oder 0)

reset:
zu löschende Standardoptionen (cxiOptPostMsgForceQueue oder 0)

return:
bisheriger Wert der Standardoptionen

Die einzige definierte Option ist cxiOptPostMsgForceQueue. Diese Option bewirkt, dass automatisch alle Meldungen über die globale Queue umgeleitet werden, sofern nicht explizit bei Post die Option cxiOptPostMsgNoForceQueue angegeben ist.

Die momentane Einstellung der globalen Optionen kann abgefragt werden, indem diese Funktion ohne Parameter aufgerufen wird (oder in C beide Parameter als 0 angegeben werden).

Zusammenfassend sind die folgenden Aufrufe sinnvoll:

PostMessageTreeOptions (cxiOptPostMsgForceQueue, 0):
Meldungen werden automatisch über die globale Queue umgeleitet.

PostMessageTreeOptions (0, cxiOptPostMsgForceQueue):
Meldungen werden nicht automatisch über die globale Queue umgeleitet.

PostMessageTreeOptions () & cxiOptPostMsgForceQueue:
Dieser Ausdruck ergibt einen Wert ungleich 0, wenn die automatische Umleitung von Meldungen über die globale Queue aktiviert ist, ansonsten 0.

Portabilität:
Die Standardoptionen sind ab Version 2.04 definiert und in allen unterstützten Systemen verfügbar. Jeder Prozess besitzt eigene Standardoptionen, beim Versenden einer Meldung gelten die Optionen des Absenders.

Siehe auch:
Allgemeines zur globalen Queue
GlobalWaitState - Globale Queue abarbeiten (mit Beispiel)
Post, PostMessageTree - Verschicken einer Meldung
Pass - Weiterleiten einer empfangenen Meldung