TTDeleteEmbeddedFont-Funktion (t2embapi.h)
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:
[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 |