RemoveFontResourceExW-Funktion (wingdi.h)

Artikel
11/20/2024

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

Syntax

BOOL RemoveFontResourceExW(
  [in] LPCWSTR name,
  [in] DWORD   fl,
  [in] PVOID   pdv
);

Parameter

[in] name

Ein Zeiger auf eine mit Null beendete 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 dem Hinzufügen der Schriftart mit der funktion AddFontResourceEx identisch sein. Weitere Informationen finden Sie in der funktion AddFontResourceEx.

[in] pdv

Reserviert. Muss null sein.

Rückgabewert

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

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

Bemerkungen

Diese Funktion entfernt die Schriftart nur, wenn die angegebenen Flags mit der AddFontResourceEx--Funktion hinzugefügt wurden.

Wenn Sie versuchen, eine vorhandene Schriftartdatei zu ersetzen, die eine Schriftart mit ausstehenden Verweisen enthält, wird möglicherweise ein Fehler angezeigt, der angibt, dass die ursprüngliche Schriftart nicht gelöscht werden kann, da sie auch nach dem Aufruf RemoveFontResourceExverwendet wird. Wenn ihre App erfordert, dass die Schriftartdatei ersetzt wird, rufen Sie RemoveFontResourceEx- in einer Schleife auf null, um die Ressourcenanzahl der ursprünglichen Schriftart auf Null zu reduzieren. 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 Schriftartregistrierung aufgeführt ist, und starten Sie das System neu, um sicherzustellen, dass die Schriftart von allen Sitzungen entladen wird.

Hinweis Apps, in denen die ursprüngliche Schriftartdatei verwendet wird, weiterhin auf die originale Datei zugreifen und die neue Schriftart erst dann verwenden, wenn die Schriftart neu geladen wird. Rufen Sie AddFontResourceEx- auf, um die Schriftart neu zu laden. Es wird empfohlen, AddFontResourceEx- dieselbe Anzahl von Male 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 );
}

Anmerkung

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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wingdi.h (enthalten Windows.h)
Library	Gdi32.lib
DLL-	Gdi32.dll

Siehe auch

AddFontResourceEx-

Schriftart- und Textfunktionen

Schriftarten und Textübersicht

SendMessage-

Freigeben über