TTDeleteEmbeddedFont-Funktion (t2embapi.h)

  • Artikel

Gibt Arbeitsspeicher frei, der von der eingebetteten Schriftart hFontReference verwendet wird.

Standardmäßig entfernt TTDeleteEmbeddedFont auch die installierte Version der Schriftart aus dem System des Benutzers. Wenn eine installierbare Schriftart geladen wird, muss diese Funktion weiterhin aufgerufen werden, um den von der eingebetteten Schriftartstruktur verwendeten Arbeitsspeicher freizugeben. Es kann jedoch ein Flag angegeben werden, das angibt, dass die Schriftart auf dem System installiert bleiben soll.

Syntax

LONG TTDeleteEmbeddedFont(
  [in]  HANDLE hFontReference,
  [in]  ULONG  ulFlags,
  [out] ULONG  *pulStatus
);

Parameter

[in] hFontReference

Behandeln Sie die identifizierende Schriftart, wie in der TTLoadEmbeddedFont-Funktion angegeben.

[in] ulFlags

Flag, das Die Optionen zum Löschen von Schriftarten angibt. Derzeit kann dieses Flag auf null oder den folgenden Wert festgelegt werden:

Wert Bedeutung
TTDELETE_DONTREMOVEFONT
 Entfernen Sie die installierte Schriftart nicht aus dem System, sondern lassen Sie den Speicher frei, der zuvor von der eingebetteten Schriftartstruktur belegt wurde.

[out] pulStatus

Derzeit undefiniert.

Rückgabewert

Bei erfolgreicher Ausführung gibt TTDeleteEmbeddedFont den Wert E_NONE zurück.

Der von der eingebetteten Schriftstruktur belegte Arbeitsspeicher wird gelöscht. Standardmäßig wird die von hFontReference angegebene Schriftart auch dauerhaft aus dem System entfernt (deinstalliert und gelöscht).

Andernfalls wird ein Fehlercode zurückgegeben, der unter Embedding-Function Error Messages beschrieben wird.

Hinweise

Der Client ist für das Aufrufen dieser Funktion verantwortlich, um Schriftarten zu entfernen, wenn die Einbettungsberechtigungen es nicht zulassen, dass eine Schriftart dauerhaft auf dem System eines Benutzers installiert wird.

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 t2embapi.h
Bibliothek T2embed.lib
DLL T2embed.dll

Weitere Informationen

TTLoadEmbeddedFont