Share via


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

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Mlang.h

IDL

Mlang.idl

DLL

Mlang.dll

See also

IMLangFontLink2