Metodo IFont::get_hFont (ocidl.h)

Recupera un handle per il tipo di carattere descritto da questo oggetto tipo di carattere.

Sintassi

HRESULT get_hFont(
  [out] HFONT *phFont
);

Parametri

[out] phFont

Puntatore alla variabile allocata dal chiamante che riceve l'handle del tipo di carattere. Il chiamante non possiede questa risorsa e non deve tentare di eliminare definitivamente il tipo di carattere.

Valore restituito

Il metodo supporta i valori restituiti standard E_UNEXPECTED e E_OUTOFMEMORY, nonché i valori seguenti.

Codice restituito	Descrizione
S_OK	L'handle del tipo di carattere è stato recuperato correttamente.
E_POINTER	L'indirizzo nel parametro phFont non è valido. Ad esempio, può essere NULL.

Commenti

Note ai chiamanti

L'oggetto carattere mantiene la proprietà dell'HFONT e può eliminarlo in qualsiasi momento senza alcuna notifica precedente. Se il chiamante deve proteggere questo tipo di carattere per un periodo di tempo limitato, può chiamare IFont::AddRefHfont e IFont::ReleaseHfont.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

IFont

IFont::AddRefHfont

IFont::ReleaseHfont