# 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