ScriptFreeCache-Funktion (usp10.h)

Artikel
03/06/2024

Gibt einen Skriptcache frei.

Syntax

HRESULT ScriptFreeCache(
  [in, out] SCRIPT_CACHE *psc
);

Parameter

[in, out] psc

Zeiger auf die SCRIPT_CACHE-Struktur .

Rückgabewert

Gibt bei Erfolg 0 zurück. Die Funktion gibt einen HRESULT-Wert ungleich null zurück, wenn sie nicht erfolgreich ist. Die Anwendung kann den Rückgabewert nicht mit den Makros SUCCEEDED und FAILED testen.

Hinweise

Eine Anwendung kann den Skriptcache jederzeit mit bestimmten Einschränkungen freigeben, wenn es sich bei der Anwendung um Multithreads handelt. Uniscribe verwaltet die Verweisanzahl in seinen Schriftarten und Shaper-Caches und gibt Schriftdaten nur frei, wenn alle Schriftgrößen frei sind. Shaperdaten werden nur freigegeben, wenn alle unterstützten Schriftarten freigegeben werden.

Die Anwendung sollte den Skriptcache für eine Formatvorlage freigeben, wenn sie diesen Stil verwirft.

ScriptFreeCache legt seinen Parameter immer auf NULL fest, um Fehlreferenzen zu vermeiden.

Uniscribe-Funktionen sind wiedereinsteigerbar. Die Cacheerstellung wird durch ein einzelnes prozessweites Semaphor miteinander verzahnt. ScriptFreeCache sollte nicht zu einem Zeitpunkt aufgerufen werden, zu dem ein anderer Thread möglicherweise auf den bestimmten Cache zugreift, um frei zu werden. Aus Leistungsgründen ist der Cache während ScriptShape oder ScriptPlace nicht gesperrt.

Wichtig Ab Windows 8: Um die Ausführung unter Windows 7 zu gewährleisten, muss ein Modul, das Uniscribe verwendet, Usp10.lib vor gdi32.lib in der Bibliotheksliste angeben.

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	usp10.h
Bibliothek	Usp10.lib
DLL	Usp10.dll
Verteilbare Komponente	Internet Explorer 5 oder höher unter Windows Me/98/95

Weitere Informationen

Share via