IFont::ReleaseHfont-Methode (ocidl.h)

Benachrichtigt das Schriftartobjekt, dass der Aufrufer, der diese Schriftart zuvor mit IFont::AddRefHfont im Cache gesperrt hat, die Sperre nicht mehr benötigt.

Syntax

HRESULT ReleaseHfont(
  [in] HFONT hFont
);

Parameter

[in] hFont

Ein Schriftarthandle, das zuvor über IFont::get_hFont realisiert wurde. Dieser Wert wurde an einen vorherigen Aufruf von IFont::AddRefHfont übergeben, um die Schriftart zu sperren, und der Aufrufer möchte nun die Schriftart im Cache entsperren.

Rückgabewert

Die Methode unterstützt die Standardrückgabewerte E_UNEXPECTED und E_INVALIDARG sowie die folgenden Werte.

Rückgabecode	BESCHREIBUNG
S_OK	Die Schriftart wurde erfolgreich entsperrt.
S_FALSE	Die Schriftart wurde nicht im Cache gesperrt. Dieser Rückgabewert ist eine gutartige Benachrichtigung an den Aufrufer, dass möglicherweise ein Problem mit der Zählung von Schriftartenverweis vorliegt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

IFont

IFont::AddRefHfont