acioFindFirstOccurrenceFromRoot

Call the acioFindFirstOccurrenceFromRoot function to locate the first occurrence of the specified tag in an XML result.

Syntax

t_aciObject* acioFindFirstOccurrenceFromRoot (
   t_aciObject* pObject, 
   char* szTag)

Arguments

Arguments Type/Description
pObject t_aciObject*  A pointer to an ACI_DATA object that is part of an XML result.
szTag 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 child object tree. If it does not find the specified szTag, it does not search pObject siblings.

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

Returns

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