　フルパスで指定したノードの値を取得します。

構文

char *XML_GetNodeValueByPath(
  XML_HANDLE hXml,
  const char *nodePath,
  int *ErrCode
);

パラメータ

　関数が成功したら指定のノードの値の文字列を指すポインタを、それ以外はNULLを返します。

　フルパスの指定に従ってノードを検索します。

　ノードが見つかったときは、そのノードの値の文字列を指すポインタを返します。

　ノードが見つかったが、そのノードが値を持たないときは、空文字("")を指すポインタを返します。

　複数のノードが見つかったときは関数が失敗し、ErrCodeに XML_NOT_UNIQUE_NODE を返します。

　見つかったノードが中間ノードだったときは関数が失敗し、ErrCodeに XML_NO_VALUE_IN_INTERMEDIATE_NODE を返します。

　関数が失敗したときはNULLを返し、ErrCodeに次のエラーコードを返します。

エラーコード	説明
XML_INVALID_PARAMETER_ERROR	パラメーターエラー
XML_MEMORY_ALLOCATION_ERROR	メモリーアロケーションエラー
XML_INVALID_XML_OBJECT_ERROR	不正なXMLハンドルが指定された。
XML_INVALID_NODE_OBJECT_ERROR	不正なノードが指定された。
XML_NOT_FOUND	指定した名前のノードが見つからなかった。
XML_NOT_UNIQUE_INTERMEDIATE_NODE	ノードパスの途中の階層で、指定された名前のノードが複数検出された。
XML_NOT_UNIQUE_NODE	同じ名前のノードが複数ある。
XML_NO_VALUE_IN_INTERMEDIATE_NODE	中間ノードは値を持たない。