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.