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 或更高版本

另请参阅

缓存

SCRIPT_CACHE

Uniscribe

Uniscribe 函数