cniFinalize

ブローカーがパーサーを要求して、指定したメッセージに対してファイナライズ処理を実行するようにします。ファイナライズとは、ヘッダー・チェーンを固定し、「プロパティー」フォルダーとヘッダーを一致させるプロセスのことです。

この処理の動作は、それぞれのパーサーに固有です。 ファイナライズ処理をサポートしないパーサーもあります。

ノードからメッセージを伝搬する前に (例えば cniWriteBuffer を呼び出す前に)、cniFinalize を呼び出します。

構文

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

パラメーター

returnCode
関数からの戻りコード (出力)。
考えられる戻りコードは以下のとおりです。
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
エレメント・ツリーをファイナライズさせるメッセージ・オブジェクトのアドレス (入力)。
options
このパラメーターを CCI_FINALIZE_NONE に設定します。

戻り値

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

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

      /* Handle errors */
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:44:35

as07590_