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

 

 

Show: