Share via

Funzione OleCreateFontIndirect (olectl.h)

  • Articolo

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