IAccDictionary::ConvertValueToString method

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

Note  Active Accessibility Text Services is deprecated. Please see Microsoft Windows Text Services Frameworkfor more information on advanced text input and natural language technologies.
 

Syntax

HRESULT ConvertValueToString(
  REFGUID Term,
  LCID    lcid,
  VARIANT varValue,
  BSTR    *pbstrResult,
  LCID    *plcid
);

Parameters

Term

Type: REFGUID

A GUID that represents a property.

lcid

Type: LCID

The locale of the string to be returned.

varValue

Type: VARIANT

The value of the item.

pbstrResult

Type: BSTR*

A pointer to the converted value.

plcid

Type: LCID*

A pointer to the language of the returned string.

Return Value

Type: HRESULT

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

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header msaatext.h
DLL Msaatext.dll
Redistributable Active Accessibility 2.0 RDK on Windows NT 4.0 with SP6 and later and Windows 98