cniFinalize

ブローカーが、 完成機能をサポートするパーサーを要求して、 指定したメッセージに対してその完成処理を実行するようにします。 この処理の動作は、それぞれのパーサーに固有です。

options パラメーターが CCI_FINALIZE_VALIDATE に設定されている場合、 パーサーは妥当性検査処理も実行して、 それが所有するエレメント・ツリーが正しい構造であることを確認する必要があります。 これは、正しく形成されていないエレメント・ツリーのメッセージが、 メッセージ・フローの他のノードに伝搬されないようにするために役立ちます。

メッセージの伝搬の前 (たとえば、cniWriteBuffer を呼び出す前) に cniFinalize を呼び出すことをお勧めします。

構文

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

パラメーター

returnCode
関数からの戻りコード (出力)。
message
エレメント・ツリーを完成させるメッセージ・オブジェクトのアドレス (入力)。
options
使用される完成または妥当性検査オプションを識別するためのビット・フラグを指定します (入力)。 このパラメーターはオプションです。これを CCI_FINALIZE_VALIDATE に設定することも可能です。

戻り値

なし。エラーが発生した場合、returnCode パラメーターがエラーの理由を示します。

      cniFinalize(&rc, outMsg, CCI_FINALIZE_NONE);
            retvalue = cniPropagate(
                                                                                               &rc,
                                                          terminalObject,
                                                          destinationList,
                                                          exceptionList,
                                                          outMsg);

        /* Handle errors */

関連概念
ユーザー定義の入力ノード
ユーザー定義のメッセージ処理ノード
ユーザー定義の出力ノード

関連タスク
C での入力ノードの作成
C でのメッセージ処理ノードの作成

関連資料
C 言語ノード・ユーティリティー関数
cniCreateMessage
cniDeleteMessage
cniGetEnvironmentMessage
cniGetMessageContext
cniPropagate
cniWriteBuffer