WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

cpiWriteBufferFormatted

この関数は、出力メッセージに関する追加情報を提供することによって、cpiWriteBuffer() インプリメンテーション関数の機能を拡張します。

以下の追加情報が提供されています。
  1. パーサーがエレメント・ツリーを出力ビット・ストリームに逐次化する際に、出力メッセージを表すために使用されるエンコードおよびコード化文字セット。
  2. その出力メッセージのメッセージ・セット、タイプ、および形式。 これらの情報は、そのエレメント・ツリーを出力ビット・ストリームに正しく逐次化するために、パーサーが必要とします。

逐次化が必要ない場合 (例えば、出力が入力ビット・ストリームに基づく場合や、ツリーが変更されていない場合)、ブローカーはこのインプリメンテーション関数を呼び出しません。

このインプリメンテーション関数が CPI_VFT 構造で提供されている場合、cpiWriteBuffer() または cpiWriteBufferEncoded() のどちらも指定できません。指定した場合、cpiDefineParserClass() 関数は失敗し、CCI_INVALID_IMPL_FUNCTION の戻りコードが出されます。

定義されている場所 タイプ メンバー
CPI_VFT 条件付き iFpWriteBufferFormatted

構文

int cpiWriteBufferFormatted(
  CciParser*     parser,
  CciContext*    context,
  int            encoding,
  int            ccsid,
  CciChar*       set,
  CciChar*       type,
  CciChar*       format); 

パラメーター

parser
パーサー・オブジェクトのアドレス (入力)。
context
パーサー・オブジェクトが所有するコンテキストのアドレス (入力)。
encoding
メッセージ・バッファーのエンコード (入力)。
ccsid
メッセージ・バッファーの CCSID (入力)。
set
メッセージが属するメッセージ・セット (入力)。
type
メッセージ・タイプ (入力)。
format
メッセージ形式 (入力)。

戻り値

バッファーでビット・ストリームに追加されるデータのサイズ (バイト数)。

サンプル

int cpiWriteBufferFormatted(
  CciParser*  parser,
  CciContext* context,
  int         encoding,
  int         ccsid
  CciChar*       set,
  CciChar*       type,
  CciChar*       format
){
  PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ;
  int                initialSize = 0;
  int                rc = 0;
  const void* a;
  CciByte b;

  
  initialSize = cpiBufferSize(&rc, parser);
  a = cpiBufferPointer(&rc, parser);
  b = cpiBufferByte(&rc, parser, 0);

  cpiAppendToBuffer(&rc, parser, (char *)"Some test data", 14);

  return cpiBufferSize(0, parser) - initialSize;
}
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:48:07


参照トピック参照トピック | バージョン 8.0.0.5 | as08230_