ihuGetStringTagPropertyByTagName

Use the ihuGetStringTagPropertyByTagname function to retrieve the value of a specified string tag property from the API tag cache for a specified tag. This call queries the cache, but not the archiver. The tag property may have changed since the cache was fetched.

Prototype

ihuGetStringTagPropertyByTagname {
  in MSO Char *Tagname,
  in ihuTagProperties TagProperty,
  in int valuelength,
  out MSO Char *Value
};

Remarks

The get by tagname function is slower than the get by index function because it loops through all tags in the cache to find the requested tag. To retrieve multiple properties for a tag, consider calling ihuGetTagnameCacheIndex to get the cache index of a tag so that you can use the get by index functions.

Returns

• ihuSTATUS_OK
• ihuSTATUS_INVALID_PARAMETER
• ihuSTATUS_INVALID_TAGNAME