Funzione AddFontMemResourceEx (wingdi.h)

Articolo
03/13/2024

La funzione AddFontMemResourceEx aggiunge la risorsa tipo di carattere da un'immagine di memoria al sistema.

Sintassi

HANDLE AddFontMemResourceEx(
  [in] PVOID pFileView,
  [in] DWORD cjSize,
  [in] PVOID pvResrved,
  [in] DWORD *pNumFonts
);

Parametri

[in] pFileView

Puntatore a una risorsa del tipo di carattere.

[in] cjSize

Numero di byte nella risorsa del tipo di carattere a cui punta pbFont.

[in] pvResrved

Riservato. Deve essere 0.

[in] pNumFonts

Puntatore a una variabile che specifica il numero di tipi di carattere installati.

Valore restituito

Se la funzione ha esito positivo, il valore restituito specifica l'handle per il tipo di carattere aggiunto. Questo handle identifica in modo univoco i tipi di carattere installati nel sistema. Se la funzione ha esito negativo, il valore restituito è zero. Non sono disponibili informazioni estese sull'errore.

Commenti

Questa funzione consente a un'applicazione di ottenere un tipo di carattere incorporato in un documento o in una pagina Web. Un tipo di carattere aggiunto da AddFontMemResourceEx è sempre privato del processo che ha effettuato la chiamata e non è enumerabile.

Un'immagine di memoria può contenere più tipi di carattere. Quando questa funzione ha esito positivo, pcFonts è un puntatore a un DWORD il cui valore è il numero di tipi di carattere aggiunti al sistema in seguito a questa chiamata. Ad esempio, questo numero può essere 2 per le facce verticali e orizzontali di un tipo di carattere asiatico.

Quando la funzione ha esito positivo, il chiamante di questa funzione può liberare la memoria a cui punta pbFont perché il sistema ha creato la propria copia della memoria. Per rimuovere i tipi di carattere installati, chiamare RemoveFontMemResourceEx. Tuttavia, quando il processo viene eliminato, il sistema scarica i tipi di carattere anche se il processo non ha chiamato RemoveFontMemResource.

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