構文
XML_Node *XML_AddChildNode(
XML_HANDLE hXml,
XML_Node *node,
const char *name,
const char *value,
int *ErrCode
);
パラメータ
- hXml
- [in] XMLハンドル
- node
- [in] ノードのXML_Node構造体を指すポインタ。
- name
- [in] 追加する子ノードの名前を指定する文字列を指すポインタ。
- value
- [in] 追加する子ノードの値を指定する文字列を指すポインタ。値を持たない空ノードを追加するときはNULLを設定します。
- ErrCode
- [out] エラーコードを返す変数を指すポインタ。エラーコードが不要のときはNULLを指定します。
戻り値
関数が成功したら追加したノードのXML_Node構造体を指すポインタを、それ以外はNULLを返します。解説
指定されたノードに指定された名前と値を持つ子ノードを追加し、追加されたノードのXML_Node構造体を指すポインタを返します。
指定されたノードが値を持っている場合は子ノードを追加できません。この場合、関数は失敗し、ErrCodeにXML_CHILD_NODE_DISALLOWED_ERRORを返します。
関数が失敗したときはNULLを返し、ErrCodeに次のエラーコードを返します。
エラーコード | 説明 |
---|---|
XML_INVALID_PARAMETER_ERROR | パラメーターエラー |
XML_MEMORY_ALLOCATION_ERROR | メモリーアロケーションエラー |
XML_INVALID_XML_OBJECT_ERROR | 不正なXMLハンドルが指定された。 |
XML_INVALID_NODE_OBJECT_ERROR | 不正なノードが指定された。 |
XML_UNICODE_CONVERSION_ERROR | ユニコードに変換できないローカルコードの文字が検出された。 |
XML_CHILD_NODE_DISALLOWED_ERROR | ノードが値が持っているため子ノードを追加できなかった。 |
必要条件
- ヘッダファイル:
-
XML.h
CodeConversion.h : ver.1.1.1以降 - ライブラリファイル:
-
libXML.a
libCodeConversion.a : ver.1.1.1以降
libSTARTUPOPH5000.a
関連事項
最終更新日:2021/10/21