TTDeleteEmbeddedFont 函数 (t2embapi.h)
释放嵌入字体 hFontReference 使用的内存。
默认情况下, TTDeleteEmbeddedFont 还会从用户的系统中删除已安装的字体版本。 加载可安装字体时,仍必须调用此函数来释放嵌入字体结构使用的内存,但可以指定一个标志来指示字体应保留在系统上。
语法
LONG TTDeleteEmbeddedFont(
[in] HANDLE hFontReference,
[in] ULONG ulFlags,
[out] ULONG *pulStatus
);
参数
[in] hFontReference
处理标识字体,如 TTLoadEmbeddedFont 函数中提供。
[in] ulFlags
指定字体删除选项的标志。 目前,此标志可以设置为零或以下值:
值 | 含义 |
---|---|
|
不要从系统中删除已安装的字体,而是释放以前由嵌入字体结构占用的内存。 |
[out] pulStatus
当前未定义。
返回值
如果成功, TTDeleteEmbeddedFont 将返回值 E_NONE。
清除嵌入字体结构占用的内存。 默认情况下, hFontReference 指示的字体也会永久删除, (从系统卸载和删除) 。
否则, 将返回 Embedding-Function Error Messages 中所述的错误代码。
注解
当嵌入权限不允许在用户的系统上永久安装字体时,客户端负责调用此函数以删除字体。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | t2embapi.h |
Library | T2embed.lib |
DLL | T2embed.dll |