IFont::ReleaseHfont

Notifies the font object that the caller that previously locked this font in the cache with IFont::AddRefHfont no longer requires the lock.

HRESULT ReleaseHfont(

HFONT hfont

//Font handle returned from IFont::GetHfont

);

Parameters

hfont: [in] Font handle previously realized through IFont::GetHfont. This value was passed to a previous call to IFont::AddRefHfont to lock the font, and the caller would now like to unlock the font in the cache.

Return Values

The method supports the standard return values E_UNEXPECTED and E_INVALIDARG, as well as the following:

S_OK: The font was unlocked successfully.
S_FALSE: The font was not locked in the cache. This return value is a benign notification to the caller that it may have a font reference counting problem.

See Also

IFont::AddRefHfont

HFONT hfont	//Font handle returned from IFont::GetHfont
);