cniFinalize

Diese Funktion veranlasst den Broker, Parser anzufordern, die die Abschlussfunktion unterstützen, damit diese die Abschlussverarbeitung der angegebenen Nachricht ausführen. Das Verhalten dieser Verarbeitung ist bei jedem Parser anders.

Wenn als Wert für den Parameter options CCI_FINALIZE_VALIDATE festgelegt wird, sollte ein Parser auch die Überprüfungsverarbeitung ausführen, um sicherzustellen, dass die zugehörige Elementstruktur die richtige Struktur hat. Dadurch wird verhindert, dass Nachrichten mit falsch formatierten Elementstrukturen an andere Knoten im Nachrichtenfluss weitergegeben werden.

Es wird empfohlen, cniFinalize aufzurufen, bevor eine Nachricht weitergegeben wird (z. B. vor dem Aufruf von cniWriteBuffer).

Syntax

void cniFinalize(
int*         returnCode,
CciMessage*  message,
int          options);

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, dessen Elementstruktur abgeschlossen werden soll (Eingabe).
options
Gibt Bitmarkierungen an, um die zu verwendenden Abschluss- oder Überprüfungsoptionen zu identifizieren (Eingabe). Dieser Parameter ist optional. Sie können dafür den Wert CCI_FINALIZE_VALIDATE festlegen.

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt der Parameter returnCode die Fehlerursache an.

Beispiel

cniFinalize(&rc, outMsg, CCI_FINALIZE_NONE);
retvalue = cniPropagate(
&rc, 
terminalObject, 
destinationList, 
exceptionList, 
outMsg);
/* Handle errors */
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
as07590_