ScriptFreeCache 函数 (usp10.h)

释放脚本缓存。

语法

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

[in, out] psc

指向 SCRIPT_CACHE 结构的指针。

如果成功，则返回 0。如果函数不成功，则返回非零 HRESULT 值。应用程序无法使用 SUCCEEDED 和 FAILED 宏测试返回值。

如果应用程序是多线程的，则应用程序可以随时释放脚本缓存，但存在一定的限制。 Uniscribe 在其字体和整形器缓存中维护引用计数，并且仅在所有大小的字体都可用时释放字体数据。它仅在释放所有受支持的字体时释放整形器数据。

应用程序在放弃该样式时应释放样式的脚本缓存。

ScriptFreeCache 始终将其参数设置为 NULL ，以帮助避免错误引用。

Uniscribe 函数是重新进入的。缓存创建通过单个进程范围的信号灯相互锁定。当另一个线程可能访问要释放的特定缓存时，不应调用 ScriptFreeCache。出于性能原因，缓存在 ScriptShape 或 ScriptPlace 期间未锁定。

重要从Windows 8开始：若要保持在 Windows 7 上运行的功能，使用 Uniscribe 的模块必须在其库列表中指定 gdi32.lib 之前的 Usp10.lib。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	usp10.h
Library	Usp10.lib
DLL	Usp10.dll
可再发行组件	Windows Me/98/95 上的 Internet Explorer 5 或更高版本