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
);

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.

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.

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in ocidl.h.