acioFindFirstEnclosedOccurrenceFromRoot

Call the acioFindFirstEnclosedOccurrenceFromRoot function to locate the first occurrence of the specified tag in an XML result from the immediate children.

Syntax

t_aciObject* acioFindFirstEnclosedOccurrenceFromRoot(
   t_aciObject* pObject, 
   const char* szTag)

Arguments

Arguments Type/Description
pObject t_aciObject*  A pointer to an ACI_DATA object that contains an XML result.
szTag const char*  A pointer to the requested tag.

Discussion

This function finds the first occurrence of the specified szTag in the XML structure represented by pObject, searching only in pObject itself and its immediate child objects. It does not search pObject’s siblings, nor its descendents beyond its immediate children.

You can only call this function for an ACI_DATA type ACI object.

Returns

A pointer to the tag’s contents or NULL if the tag is not found.