IFont::get_hFont-Methode (ocidl.h)

Ruft ein Handle für die Schriftart ab, die von diesem Schriftartobjekt beschrieben wird.

Syntax

HRESULT get_hFont(
  [out] HFONT *phFont
);

Parameter

[out] phFont

Ein Zeiger auf die vom Aufrufer zugewiesene Variable, die das Schriftarthandle empfängt. Der Aufrufer besitzt diese Ressource nicht und darf nicht versuchen, die Schriftart zu zerstören.

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Das Schriftarthandle wurde erfolgreich abgerufen.
E_POINTER	Die Adresse im parameter phFont ist ungültig. Es kann z. B. NULL sein.

Hinweise

Hinweise für Anrufer

Das Schriftartobjekt behält den Besitz des HFONT und kann es jederzeit ohne vorherige Benachrichtigung zerstören. Wenn der Aufrufer diese Schriftart für einen begrenzten Zeitraum sichern muss, kann er IFont::AddRefHfont und IFont::ReleaseHfont aufrufen.

Anforderungen

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

IFont::ReleaseHfont