IMLangFontLink2::MapFont Method

---

Creates a font to output the characters from the given set of code pages.

Syntax

HRESULT MapFont(
    HDC hDC, 
    DWORD dwCodePages, 
    HFONT hSrcFont, 
    HFONT *phDestFont
);

Parameters

hDC

[in] Handle to a device context.

dwCodePages

[in] Source set of code pages.

hSrcFont

[in] Handle to the source font object from which phDestFont will be inherited.

phDestFont

[out] Address of a font object where the created font will be returned.

Return Value

Returns S_OK if successful, or E_FAIL if an error occurs.

Remarks

MLang implements a font cache to store the custom fonts created by this method. When a client has finished using a font created by MapFont, it should call IMLangFontLink2::ReleaseFont to remove the font object from the cache.

Unlike IMLangFontLink::MapFont, IMLangFontLink2::MapFont supports non-Windows® code page character font linking.

Windows CE

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