aciObjectGetTagValueWithDefault

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

Syntax

aciError aciObjectGetTagValueWithDefault (
   t_aciObject* pObject, 
   char* szTagName, 
   char** pszTagValue,
   char* szDefault)

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.
szDefault char*  A pointer to the default string.

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 the szDefault string.

Returns

An ACI error code.