Call the aciObjectGetTagValue
function to obtain the value associated with the first occurrence of a tag.
aciError aciObjectGetTagValueWithDefault ( t_aciObject* pObject, char* szTagName, char** pszTagValue, char* szDefault)
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. |
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.
An ACI error code.
|