IMLangFontLink2::GetFontUnicodeRanges Method

---

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

Syntax

HRESULT GetFontUnicodeRanges(
    HDC hDC,
    UINT *puiRanges,
    UNICODERANGE* pUranges
);

Parameters

hDC

[in] Handle to the device context.

puiRanges

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

pUranges

[out] Address of 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 will return S_OK if puiRanges is not NULL and it returns a pointer to the font's UNICODERANGE structure. If puiRanges is NULL, IMLangFontLink2::GetFontUnicodeRanges will return S_OK if the method returns the number of font Unicode ranges in puiRanges.

If either the puiRanges or pUranges parameter is invalid, IMLangFontLink2::GetFontUnicodeRanges will return E_FAIL.

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0