IFont::ReleaseHfont method (ocidl.h)

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(
  [in] HFONT hFont


[in] hFont

A font handle previously realized through IFont::get_hFont. 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 value

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

Return code Description
The font was unlocked successfully.
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.


Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header ocidl.h

See also