cniFinalize

Verursacht, dass der Broker Parser anfordert, welche die Finalisierungsfunktion unterstützen, um dieabschließende Verarbeitung der angegebenen Nachricht durchzuführen. Das Verhalten dieser Verarbeitung ist für jeden Parser spezifisch.

Wenn der Parameter options auf CCI_FINALIZE_VALIDATE gesetzt ist, sollte ein Parser auch eine Prüfungsverarbeitung durchführen, um sicherzustellen, dass der eignende Elementbaum die korrekte Struktur aufweist. Die hilft vorzubeugen, dass Nachrichten mit fehlerhaften Elementbäumen an andere Knoten im Nachrichtenfluss weitergegeben werden.

Es wird empfohlen, cniFinalize vor der Weitergabe einer Nachricht (z. B. vor dem Aufrufen von cniWriteBuffer) aufzurufen.

Syntax

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

Parameter

returnCode
Der Rückkehrcode von der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
Die Adresse des Nachrichtenobjekts, für das der Elementbaum finalisiert werden soll (Eingabe).
options
Gibt die Bitflags an, um die zu verwendenden Finalisierungs- oder Prüfoptionen zu identifizieren (Eingabe). Dieser Parameter ist optional. Sie können ihn auf CCI_FINALIZE_VALIDATE setzen.

Rückgabewerte

Keine. Beim Auftreten eines Fehlers gibt der Parameter returnCode den Grund dafür 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: 23. Aug. 2006
as07590_