OPH-5000i SDK Manual

Syntax

XML_Node *XML_SetChildNodeValueByPath(
  XML_HANDLE hXml,
  XML_Node *parentNode,
  const char *childNodePath,
  const char *value,
  int *ErrCode
);

Parameters

hXml

[in] XML handle

parentNode

[in] A pointer to the XML_Node structure of the parent node.

childNodePath

[in] A pointer to a string that specifies the relative path.

value

[in] A pointer to a string of the value to set on a node.

ErrCode

[out] A pointer to a variable that returns an error code. Specify NULL when no error code is required.

Return value

If the function succeeds, it returns a pointer to the XML_Node structure of the node for which you set the value, otherwise NULL.

Remarks

Finds a node according to the specified parent node and relative path.

If a node is found, sets the specified value to the node and returns a pointer to the XML_Node structure of that node.

If all higher intermediate nodes other than the last node in the relative path are found and can be uniquely identified, but only the last node is not found, adds a new node with the name of the last node, sets the specified value to the node and returns a pointer to XML_Node structure of the node.

If multiple nodes are found, the function fails and returns XML_NOT_UNIQUE_NODE in ErrCode.

If the node found is an intermediate node, the function fails and returns XML_NO_VALUE_IN_INTERMEDIATE_NODE in ErrCode.

If the function fails, it returns NULL and ErrCode returns the following error code:

Requirements

See also

Last updated: 2021/10/21