cniCreateElementBefore

この関数を使用して、新しい構文エレメントを作成し、指定した構文エレメントの前にこれを挿入します。 新しいエレメントは、指定したエレメントの直前の兄弟になり、同じ親エレメントを共用します。

所有パーサーをフォルダーと関連付けないため、メッセージ本体フォルダー (XML、XMLNS、MRM、BLOB など) を作成する時には、cniCreateElementBefore を使用しないでください。 メッセージ本体フォルダーを作成するために、以下のいずれかの関数を使用することができます。

メッセージ本体フォルダーが作成されると、cniCreateElementBefore を使用してフォルダーの下にエレメントを作成することができます。 メッセージ本体フォルダーと関連付けられているパーサーが継承されるので、cniCreateElementBefore を使用することができます。

構文

CciElement* cniCreateElementBefore(
  int*         returnCode,
  CciElement*  targetElement);

パラメーター

returnCode
関数からの戻りコード (出力)。
考えられる戻りコードは以下のとおりです。
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
ターゲット・エレメント・オブジェクトのアドレス (入力)。

戻り値

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

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

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
最終更新

        最終更新 : 2012-07-13 15:43:54


参照トピック参照トピック | バージョン 8.0.0.1 | as07820_