Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This 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] Pointer to an unsigned integer value that specifies the number of elements in the array pointed to by the pUrangesparameter.

pUranges

[out] Pointer to the UNICODERANGEstructure that contains the Unicode range information. If this parameter is NULL, the function returns the number of font Unicode ranges in the value pointed to by the puiRangesparameter.

Return Value

Returns S_OK if successful or E_FAIL otherwise.

Remarks

This method returns S_OK if puiRangesis not NULL and it returns a pointer to the font's UNICODERANGEstructure. If puiRangesis NULL, this method returns S_OK if the method returns the number of font Unicode ranges in puiRanges.

Requirements

Header mlang.h, mlang.idl
Library mlang.dll
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later