Funzione TTDeleteEmbeddedFont (t2embapi.h)

Articolo
03/05/2024

Rilascia la memoria usata da un tipo di carattere incorporato, hFontReference.

Per impostazione predefinita, TTDeleteEmbeddedFont rimuove anche la versione installata del tipo di carattere dal sistema dell'utente. Quando viene caricato un tipo di carattere installabile, questa funzione deve comunque essere chiamata per rilasciare la memoria utilizzata dalla struttura dei tipi di carattere incorporata, ma è possibile specificare un flag che indica che il tipo di carattere deve rimanere installato nel sistema.

Sintassi

LONG TTDeleteEmbeddedFont(
  [in]  HANDLE hFontReference,
  [in]  ULONG  ulFlags,
  [out] ULONG  *pulStatus
);

Parametri

[in] hFontReference

Gestire l'identificazione del tipo di carattere, come specificato nella funzione TTLoadEmbeddedFont .

[in] ulFlags

Flag che specifica le opzioni di eliminazione dei tipi di carattere. Attualmente, questo flag può essere impostato su zero o sul valore seguente:

Valore	Significato
TTDELETE_DONTREMOVEFONT	Non rimuovere il tipo di carattere installato dal sistema, ma rilasciare la memoria occupata in precedenza dalla struttura del carattere incorporata.

[out] pulStatus

Attualmente non definito.

Valore restituito

Se ha esito positivo, TTDeleteEmbeddedFont restituisce un valore di E_NONE.

La memoria occupata dalla struttura del tipo di carattere incorporato viene cancellata. Per impostazione predefinita, anche il tipo di carattere indicato da hFontReference viene rimosso definitivamente (disinstallato ed eliminato) dal sistema.

In caso contrario, restituisce un codice di errore descritto in Embedding-Function Error Messages.Otherwise, returns an error code described in Embedding-Function Error Messages.

Commenti

Il client è responsabile della chiamata di questa funzione per rimuovere i tipi di carattere quando i privilegi di incorporamento non consentono l'installazione permanente di un tipo di carattere nel sistema di un utente.

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	t2embapi.h
Libreria	T2embed.lib
DLL	T2embed.dll

Vedi anche

TTLoadEmbeddedFont

Condividi tramite