ScriptFreeCache 函数 (usp10.h)

释放脚本缓存。

语法

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

参数

[in, out] psc

指向 SCRIPT_CACHE 结构的指针。

返回值

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

注解

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

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

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

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

重要从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 函数