Funzione OleCreateFontIndirect (olectl.h)

Articolo
03/01/2024

Crea e inizializza un oggetto carattere standard usando una descrizione iniziale delle proprietà del tipo di carattere in una struttura FONTDESC . La funzione restituisce un puntatore dell'interfaccia al nuovo oggetto carattere specificato dal chiamante nel parametro riid. Una chiamata QueryInterface fa parte di questa chiamata. Il chiamante è responsabile della chiamata a Release tramite il puntatore dell'interfaccia restituito.

Sintassi

WINOLECTLAPI OleCreateFontIndirect(
  [in]  LPFONTDESC lpFontDesc,
  [in]  REFIID     riid,
  [out] LPVOID     *lplpvObj
);

Parametri

[in] lpFontDesc

Indirizzo di una struttura del chiamante allocata, FONTDESC contenente lo stato iniziale del tipo di carattere. Questo valore non deve essere NULL.

[in] riid

Riferimento all'identificatore dell'interfaccia che descrive il tipo di puntatore dell'interfaccia da restituire in lplpvObj.

[out] lplpvObj

Indirizzo della variabile puntatore che riceve il puntatore dell'interfaccia richiesto in riid. Al termine della restituzione, questo parametro contiene il puntatore dell'interfaccia richiesto nell'oggetto carattere appena creato. Se ha esito positivo, il chiamante è responsabile della chiamata a Release tramite questo puntatore dell'interfaccia quando il nuovo oggetto non è più necessario. Se non è riuscito, il valore di è impostato su NULL.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Codice restituito	Descrizione
E_NOINTERFACE	L'identificatore dell'interfaccia specificato non è valido.
E_UNEXPECTED	Si è verificato un errore imprevisto.
E_OUTOFMEMORY	Memoria insufficiente per l'operazione.
E_INVALIDARG	Uno o più parametri non sono validi.
E_POINTER	L'indirizzo in pFontDesc o ppvObj non è valido. Si noti che se pFontDesc è impostato su NULL, la funzione restituisce NO_ERROR.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	olectl.h
Libreria	OleAut32.lib
DLL	OleAut32.dll

Vedi anche

FONTDESC

Condividi tramite