TTDeleteEmbeddedFont 函数 (t2embapi.h)

释放嵌入字体 hFontReference 使用的内存。

默认情况下, TTDeleteEmbeddedFont 还会从用户的系统中删除已安装的字体版本。 加载可安装字体时,仍必须调用此函数来释放嵌入字体结构使用的内存,但可以指定一个标志来指示字体应保留在系统上。

语法

LONG TTDeleteEmbeddedFont(
  [in]  HANDLE hFontReference,
  [in]  ULONG  ulFlags,
  [out] ULONG  *pulStatus
);

参数

[in] hFontReference

处理标识字体,如 TTLoadEmbeddedFont 函数中提供。

[in] ulFlags

指定字体删除选项的标志。 目前,此标志可以设置为零或以下值:

含义
TTDELETE_DONTREMOVEFONT
不要从系统中删除已安装的字体,而是释放以前由嵌入字体结构占用的内存。

[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

另请参阅

TTLoadEmbeddedFont