cniElementName

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

構文

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

パラメーター

returnCode
関数からの戻りコード (出力)。
考えられる戻りコードは以下のとおりです。
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
ターゲット構文エレメント・オブジェクトのアドレス (入力)。
value
エレメント名のコピー先のバッファーのアドレス (入力)。
length
value パラメーターで指定される、文字単位の長さ (入力)。

戻り値

  • 正常に実行されると、提供されるバッファーにエレメント名がコピーされ、コピーされた CciChar 文字の数が戻されます。
  • バッファーの大きさが不十分で属性値を含めることができない場合、returnCode は CCI_BUFFER_TOO_SMALL に設定され、必要な CciChar の数が戻されます。
  • その他の障害が発生した場合、CCI_FAILURE が戻され、returnCode がエラーの理由を示します。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
as07890_