Share via

IAccDictionary::ConvertValueToString

  • Article

Clients call the IAccDictionary::ConvertValueToString method to convert a value to a localized string.

HRESULT ConvertValueToString(
REFGUIDTerm,LCIDlcid,VARIANTvarValue,BSTR* pbstrResult,LCID* plcid);

Parameters

  • Term
    [in] A GUID that represents a property.
  • lcid
    [in] The locale of the string to be returned.
  • varValue
    [in] The value of the item.
  • pbstrResult
    [out] A pointer to the converted value.
  • plcid
    [out] A pointer to the language of the returned string.

Return Values

If successful, returns S_OK.

Remarks

If the Term parameter can be true or false, ConvertValueToString will return a localized string or TRUE or FALSE. If the Term parameter represents a color, ConvertValueToString will return a string for the closest color name. If the Term parameter is not found in the dictionary, then pbstrResult will be NULL.

Requirements

**  Windows NT/2000/XP/Server 2003:** Included in Windows XP and Windows Server 2003.
**  Windows 95/98/Me:** Unsupported.
**  Redistributable:** Requires Active Accessibility 2.0 RDK on Windows NT 4.0 SP6 and Windows 98.
**  Header:** Declared in Msaatext.h.