CXI-Basis-Programmierreferenz / Version 2 / Datenaustausch / Ebene 1 /
CxiError SendMessageBlock (CxiNode& cxi, const char *mi)
CxiError cxiSendMessageBlock (CxiHandle cxi, const char *mi)
Verschickt eine Meldung und wartet auf Antwort
cxi:
Daten/Inhalt der Meldung, darf nicht read-only sein
mi:
Empfänger der Meldung
return:
0 ok, sonst Fehler
SendMessageBlock verschickt die Meldung zum angegebenen Empfänger, wartet auf die Verarbeitung der Daten und kehrt erst dann zum Aufrufer zurück. Ein Returncode von 0 zeigt an, dass der Empfänger existiert und die Meldung erfolgreich verschickt und empfangen wurde.
Der Empfänger kann beliebige Änderungen in den Daten des CXI-Knotens cxi durchführen, sie gelten anschließend auch für den Sender, d.h. der Inhalt von cxi ist nach dem Aufruf dieser Funktion verändert.
Die Variable "MSG.RESULT" wird vom Meldungssystem in den Block cxi eingetragen, sie enthält den numerischen Returncode der Routine, die die Meldung verarbeitet hat.
Um eine Meldung zu verschicken, ohne auf den Empfänger zu warten, ist die Funktion PostMessageBlock zu verwenden.
Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar.
Siehe auch:
PostMessageBlock
class CxiMessageHandlerBase - Basisempfänger
class CxiMessageHandler - Meldungsempfänger