Funzione AddFontResourceExA (wingdi.h)
La funzione AddFontResourceEx aggiunge la risorsa carattere dal file specificato al sistema. I tipi di carattere aggiunti alla funzione AddFontResourceEx possono essere contrassegnati come privati e non enumerabili.
Sintassi
int AddFontResourceExA(
[in] LPCSTR name,
[in] DWORD fl,
[in] PVOID res
);
Parametri
[in] name
Puntatore a una stringa di caratteri con terminazione null contenente un nome di file di carattere valido. Questo parametro può specificare uno dei file seguenti.
Per aggiungere un tipo di carattere le cui informazioni provengono da diversi file di risorse, puntare lpszFileName a una stringa con i nomi di file separati da un | --ad esempio, abcxxxxx.pfm | abcxxxxx.pfb.
[in] fl
Caratteristiche del tipo di carattere da aggiungere al sistema. Questo parametro può avere uno dei valori seguenti.
[in] res
Riservato. Deve essere zero.
Valore restituito
Se la funzione ha esito positivo, il valore restituito specifica il numero di tipi di carattere aggiunti.
Se la funzione ha esito negativo, il valore restituito è zero. Non sono disponibili informazioni di errore estese.
Commenti
Questa funzione consente a un processo di usare tipi di carattere senza consentire ad altri processi l'accesso ai tipi di carattere.
Quando un'applicazione non ha più bisogno di una risorsa di carattere caricata chiamando la funzione AddFontResourceEx , deve rimuovere la risorsa chiamando la funzione RemoveFontResourceEx .
Questa funzione installa il tipo di carattere solo per la sessione corrente. Quando il sistema viene riavviato, il tipo di carattere non sarà presente. Per avere installato il tipo di carattere anche dopo il riavvio del sistema, il tipo di carattere deve essere elencato nel Registro di sistema.
Un tipo di carattere elencato nel Registro di sistema e installato in una posizione diversa dalla cartella %windir%\font\ non può essere modificata, eliminata o sostituita finché viene caricata in qualsiasi sessione. Per modificare uno di questi tipi di carattere, deve prima essere rimosso chiamando RemoveFontResource, rimosso dal registro dei tipi di carattere (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts) e riavviato il sistema. Dopo il riavvio del sistema, il tipo di carattere non verrà più caricato e può essere modificato.
Nota
L'intestazione wingdi.h definisce AddFontResourceEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 |