cniElementName

指定した構文エレメントの name 属性の値を取得します。 この構文エレメント名は、cniSetElementName または cpiSetElementName を使用して事前に設定されています。

構文

CciSize cniElementName(
    int*                        returnCode,
    CciElement*     targetElement,
    const CciChar*             value,
  Ccisize         length);

パラメーター

returnCode
関数からの戻りコード (出力)。
targetElement
ターゲット構文エレメント・オブジェクトのアドレス (入力)。
value
エレメント名のコピー先のバッファーのアドレス (入力)。
length
value パラメーターで指定される、文字単位の長さ (入力)。

戻り値

  • 正常に実行されると、提供されるバッファーにエレメント名がコピーされ、コピーされた CciChar 文字の数が戻されます。
  • バッファーの大きさが不十分でエレメント名を含めることができない場合、returnCode は CCI_BUFFER_TOO_SMALL に設定され、必要なバイト数が戻されます。
  • その他の障害が発生した場合、CCI_FAILURE が戻され、returnCode がエラーの理由を示します。

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

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

関連資料
C 言語ノード・ユーティリティー関数
cniElementAsBitstream
cniElementNamespace
cniElementType
cniElementValue グループ
cniElementValueState
cniElementValueType
cniElementValueValue
cniSetElementName
cpiSetElementName