RemoveFontResourceExA-Funktion (wingdi.h)

Artikel
03/04/2024

Die RemoveFontResourceEx-Funktion entfernt die Schriftarten in der angegebenen Datei aus der Systemschriftarttabelle.

Syntax

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

Parameter

[in] name

Ein Zeiger auf eine NULL-endende Zeichenfolge, die eine Schriftartressourcendatei benennt.

[in] fl

Die Merkmale der Schriftart, die aus dem System entfernt werden soll. Damit die Schriftart entfernt werden kann, müssen die verwendeten Flags mit denen identisch sein, als die Schriftart mit der AddFontResourceEx-Funktion hinzugefügt wurde. Weitere Informationen finden Sie in der AddFontResourceEx-Funktion .

[in] pdv

Reserviert. Muss Null sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Es sind keine erweiterten Fehlerinformationen verfügbar.

Hinweise

Diese Funktion entfernt die Schriftart nur, wenn die angegebenen Flags mit denen identisch sind, als die Schriftart mit der AddFontResourceEx-Funktion hinzugefügt wurde.

Wenn Sie versuchen, eine vorhandene Schriftartdatei, die eine Schriftart enthält, durch ausstehende Verweise darauf zu ersetzen, erhalten Sie möglicherweise einen Fehler, der angibt, dass die ursprüngliche Schriftart nicht gelöscht werden kann, da sie auch nach dem Aufruf von RemoveFontResourceEx verwendet wird. Wenn für Ihre App das Ersetzen der Schriftartdatei erforderlich ist, rufen Sie RemoveFontResourceEx in einer Schleife auf, um die Ressourcenanzahl der ursprünglichen Schriftart auf Null zu reduzieren, wie in diesem Beispielcode gezeigt. Wenn Sie weiterhin Fehler erhalten, ist dies ein Hinweis darauf, dass die Schriftartdatei in anderen Sitzungen geladen bleibt. Stellen Sie sicher, dass die Schriftart nicht in der Schriftartenregistrierung aufgeführt ist, und starten Sie das System neu, um sicherzustellen, dass die Schriftart aus allen Sitzungen entladen wird.

Hinweis Apps, in denen die ursprüngliche Schriftartdatei verwendet wird, können weiterhin auf die originale Datei zugreifen und verwenden die neue Schriftart erst, wenn die Schriftart erneut geladen wird. Rufen Sie AddFontResourceEx auf, um die Schriftart erneut zu laden. Es wird empfohlen, AddFontResourceEx so oft aufzurufen, wie der Aufruf von RemoveFontResourceEx erfolgreich war, wie in diesem Beispielcode gezeigt.


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

// TODO: Replace font file

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

Hinweis

Der wingdi.h-Header definiert RemoveFontResourceEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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

AddFontResourceEx

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

SendMessage

Freigeben über