Freigeben über


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