AddFontMemResourceEx-Funktion (wingdi.h)
Die AddFontMemResourceEx-Funktion fügt die Schriftartressource aus einem Speicherbild dem System hinzu.
Syntax
HANDLE AddFontMemResourceEx(
[in] PVOID pFileView,
[in] DWORD cjSize,
[in] PVOID pvResrved,
[in] DWORD *pNumFonts
);
Parameter
[in] pFileView
Ein Zeiger auf eine Schriftartressource.
[in] cjSize
Die Anzahl der Bytes in der Schriftartressource, auf die pbFont verweist.
[in] pvResrved
Reserviert. Muss den Wert 0 (null) haben.
[in] pNumFonts
Ein Zeiger auf eine Variable, die die Anzahl der installierten Schriftarten angibt.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt der Rückgabewert das Handle für die hinzugefügte Schriftart an. Dieses Handle identifiziert eindeutig die Schriftarten, die auf dem System installiert wurden. Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Es sind keine erweiterten Fehlerinformationen verfügbar.
Hinweise
Mit dieser Funktion kann eine Anwendung eine Schriftart abrufen, die in ein Dokument oder eine Webseite eingebettet ist. Eine Schriftart, die von AddFontMemResourceEx hinzugefügt wird, ist immer privat für den Prozess, der den Aufruf ausgeführt hat, und ist nicht aufzählbar.
Ein Speicherbild kann mehrere Schriftarten enthalten. Wenn diese Funktion erfolgreich ist, ist pcFonts ein Zeiger auf ein DWORD , dessen Wert die Anzahl der Schriftarten ist, die dem System als Ergebnis dieses Aufrufs hinzugefügt wurden. Diese Zahl kann z. B. 2 für die vertikalen und horizontalen Gesichter einer asiatischen Schriftart sein.
Wenn die Funktion erfolgreich ist, kann der Aufrufer dieser Funktion den Speicher freigeben, auf den pbFont verweist, da das System eine eigene Kopie des Arbeitsspeichers erstellt hat. Um die installierten Schriftarten zu entfernen, rufen Sie RemoveFontMemResourceEx auf. Wenn der Prozess jedoch abläuft, entlädt das System die Schriftarten auch dann, wenn der Prozess RemoveFontMemResource nicht aufgerufen hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |
Weitere Informationen
Schriftart- und Textfunktionen