cniWriteBuffer

Schreibt die Baumstruktur des Syntaxelements, das mit der angegebenen Nachricht verknüpft ist, in den Datenpuffer, dessen Eigner das Nachrichtenobjekt ist. Diese Funktion wird normalerweise von Sendeknoten verwendet. Diese Operation serialisiert die Elementstruktur in einen Bitstrom, der anschließend als Sequenz aufeinanderfolgender Bytes verarbeitet werden kann. Diese Funktion sollte verwendet werden, wenn der Bitstrom in ein Ziel geschrieben wird, das sich außerhalb des Brokers befindet.

Sie müssen vor diesem Aufruf cniFinalize aufrufen, damit alles funktioniert.

Syntax

void cniWriteBuffer(
  int*         returnCode,
  CciMessage*  message);

Parameter

returnCode
Der Rückkehrcode aus der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
Die Adresse des Nachrichtenobjekts, für das die Elementbaumtstruktur serialisiert werden soll (Eingabe).

Rückgabewerte

Keine. Beim Auftreten eines Fehlers gibt der Parameter returnCode den Grund dafür an.

Beispiel

cniCopyElementTree(&rc, inLastChild, outLastChild);
cniFinalize(&rc, outMessage);
cniWriteBuffer(&rc, outMessage);
Zugehörige Konzepte
Benutzerdefinierte Sendeknoten
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as07670_