IMLangFontLink2::GetFontUnicodeRanges method

Gets information about which Unicode characters are supported by a font.

Syntax

HRESULT GetFontUnicodeRanges(
  [in]      HDC          hDC,
  [in, out] UINT         *puiRanges,
  [out]     UNICODERANGE *pUranges
);

Parameters

• hDC [in]
  A handle to the device context.

• puiRanges [in, out]
  An unsigned integer value that specifies the number of elements in the array pointed to by the pUranges parameter.

• pUranges [out]
  A pointer to the UNICODERANGE structure that contains the Unicode range information. If this parameter is NULL, the function returns the number of font Unicode ranges in puiRanges.

Return value

Returns S_OK if successful, or E_FAIL otherwise.

Remarks

IMLangFontLink2::GetFontUnicodeRanges returns S_OK, if puiRanges is not NULL and it returns a pointer to the font's UNICODERANGE structure. If puiRanges is NULL, IMLangFontLink2::GetFontUnicodeRanges returns the number of font Unicode ranges in puiRanges.

If the puiRanges parameter or the pUranges parameter is invalid, IMLangFontLink2::GetFontUnicodeRanges returns E_FAIL.

Requirements

See also

IMLangFontLink2