cniCreateElementAfterUsingParser

新しい構文エレメントを作成し、指定した構文エレメントの後にこれを挿入し、指定したパーサー・クラス名にこれを関連付けます。 新しいエレメントは、指定したエレメントの次の兄弟になります。

パーサーによって所有される構文エレメント・ツリーの部分は、エレメントの最初の世代 (つまり、ルートのすぐ下にある子) に存在する有効なルートだけを所有できます。 ユーザー定義ノード・インターフェースは、異なるパーサーによって所有されると思われるサブツリーを作成する機能を制限しません。 ただし、メッセージの出力時には、これらのエレメント・ツリーをビット・ストリームに逐次化することはできません。

WebSphere Message Broker が提供しているパーサーの名前を指定する場合、パーサーの正しいクラス名を使用しなければなりません。

BLOB パーサーの内部名は none です。そのため、BLOB パーサー・フォルダーを作成するためにこの機能を使用する場合、関連付けられたパーサー名を none にする必要があります。

構文

CciElement* cniCreateElementAfterUsingParser(
  int* returnCode,
  CciElement* targetElement,
  const CciChar* parserClassName);

パラメーター

returnCode
関数からの戻りコード (出力)。
考えられる戻りコードは以下のとおりです。
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_PARSER_NAME
TargetElement
エレメント・オブジェクトのアドレス (入力)。
parserClassName
パーサー・クラスの名前 (入力)。

戻り値

成功した場合、新規エレメント・オブジェクトのアドレスが戻されます。 失敗した場合、ゼロの値 (CCI_NULL_ADDR) が戻され、returnCode パラメーターがエラーの理由を示します。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
as07810_