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

DESIGNVECTOR

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

RemoveFontMemResourceEx

SendMessage