Funzione RemoveFontResourceExA (wingdi.h)

Articolo
03/04/2024

La funzione RemoveFontResourceEx rimuove i tipi di carattere nel file specificato dalla tabella dei tipi di carattere di sistema.

Sintassi

BOOL RemoveFontResourceExA(
  [in] LPCSTR name,
  [in] DWORD  fl,
  [in] PVOID  pdv
);

Parametri

[in] name

Puntatore a una stringa con terminazione Null che assegna un nome a un file di risorse del tipo di carattere.

[in] fl

Caratteristiche del tipo di carattere da rimuovere dal sistema. Affinché il tipo di carattere venga rimosso, i flag utilizzati devono essere uguali a quando il tipo di carattere è stato aggiunto con la funzione AddFontResourceEx . Per altre informazioni, vedere la funzione AddFontResourceEx .

[in] pdv

Riservato. Deve essere zero.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Non sono disponibili informazioni estese sull'errore.

Commenti

Questa funzione rimuoverà il tipo di carattere solo se i flag specificati sono uguali a quando il tipo di carattere è stato aggiunto con la funzione AddFontResourceEx .

Quando si tenta di sostituire un file di carattere esistente che contiene un tipo di carattere con riferimenti in sospeso, è possibile che venga visualizzato un errore che indica che il tipo di carattere originale non può essere eliminato perché è in uso anche dopo aver chiamato RemoveFontResourceEx. Se l'app richiede che il file del tipo di carattere venga sostituito, per ridurre il numero di risorse del tipo di carattere originale a zero, chiamare RemoveFontResourceEx in un ciclo, come illustrato in questo codice di esempio. Se si continuano a ricevere errori, si tratta di un'indicazione che il file del tipo di carattere rimane caricato in altre sessioni. Assicurarsi che il tipo di carattere non sia elencato nel Registro di sistema dei tipi di carattere e riavviare il sistema per assicurarsi che il tipo di carattere venga scaricato da tutte le sessioni.

Nota Le app in cui è in uso il file del tipo di carattere originale potranno comunque accedere al file originale e non useranno il nuovo tipo di carattere finché il tipo di carattere non viene ricaricato. Chiama AddFontResourceEx per ricaricare il tipo di carattere. È consigliabile chiamare AddFontResourceEx lo stesso numero di volte in cui la chiamata a RemoveFontResourceEx ha avuto esito positivo, come illustrato in questo codice di esempio.


int i = 0;
while( RemoveFontResourceEx( FontFile, FR_PRIVATE, 0 ) )
{
    i++;
}

// TODO: Replace font file

while( i-- )
{
    AddFontResourceEx( FontFile, FR_PRIVATE, 0 );
}

Nota

L'intestazione wingdi.h definisce RemoveFontResourceEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll

Vedi anche

AddFontResourceEx

Funzioni per tipi di carattere e testo

Cenni preliminari su tipi di carattere e testo

SendMessage

Condividi tramite