acioGetTagValue

Call the acioGetTagValue function to obtain the value associated with the first occurrence of a tag.

Syntax

aciError acioGetTagValue (
   t_aciObject* pObject, 
   char* szTagName, 
   char** pszTagValue)

Arguments

Arguments Type/Description
pObject t_aciObject*  A pointer to an ACI_DATA type object.
szTag char*  A pointer to the requested tag.
pszTagValue char**  The contents associated with the tag.

Discussion

This function finds the first occurrence of the specified szTagName, extracts its character value, and sets the pointer pszTagValue to the memory space (allocated by this function) where it stores the character value. If there is no tag with the specified name or if that tag does not contain character data, pszTagValue points to a NULL character.

Returns

An ACI error code.