TTGetEmbeddedFontInfo 函数 (t2embapi.h)

  • 项目

检索有关嵌入字体的信息，例如嵌入权限。 TTGetEmbeddedFontInfo 执行与 TTLoadEmbeddedFont 相同的任务，但不为嵌入字体分配内部数据结构。

语法

LONG TTGetEmbeddedFontInfo(
  [in]  ULONG         ulFlags,
  [out] ULONG         *pulPrivStatus,
  [in]  ULONG         ulPrivs,
  [out] ULONG         *pulStatus,
        READEMBEDPROC lpfnReadFromStream,
  [in]  LPVOID        lpvReadStream,
  [in]  TTLOADINFO    *pTTLoadInfo
);

参数

[in] ulFlags

指定请求的标志。 此标志可以具有以下零个或多个值。

值 含义
TTEMBED_EMBEDEUDC
 将关联的 EUDC 字体文件数据与字体结构包含在内。
TTEMBED_RAW
 返回一个字体结构，其中包含非压缩的完整字符集。 这是函数的默认行为。
TTEMBED_SUBSET
 返回仅包含 pusCharCodeSet 或 pulCharCodeSet 参数指示的字形的子集字体。 这些字符代码必须表示为 16 位或 UCS-4 字符，视 参数而定。
TTEMBED_TTCOMPRESSED
 返回压缩的字体结构。

[out] pulPrivStatus

完成后，指示字体的嵌入权限。 可能的值列表如下：

值 含义
EMBED_PREVIEWPRINT
 预览和打印嵌入。
EMBED_EDITABLE
 可编辑的嵌入。
EMBED_INSTALLABLE
 可安装的嵌入。
EMBED_NOEMBEDDING
 受限许可证嵌入。

[in] ulPrivs

指示客户端施加的嵌入权限的进一步限制的标志。 有关其他信息，请参阅 TTLoadEmbeddedFont 。

此标志必须具有以下值之一。

值 含义
LICENSE_PREVIEWPRINT
 预览和打印嵌入。
LICENSE_EDITABLE
 可编辑的嵌入。
LICENSE_INSTALLABLE
 可安装的嵌入。
LICENSE_NOEMBEDDING
 受限许可证嵌入。
LICENSE_DEFAULT
 使用默认嵌入级别。

[out] pulStatus

指向包含状态信息的位域的指针，并在完成此函数时填充。 状态可以是零或以下值：

值 含义
TTLOAD_FONT_SUBSETTED
 加载的字体是原始字体的子集。

lpfnReadFromStream

[callback]指向客户端定义的回调函数的指针，该函数从文档流中读取字体结构。

[in] lpvReadStream

当前未定义。 为指向流 (字体结构) 的指针保留。

[in] pTTLoadInfo

指向 TTLOADINFO 结构的指针，该结构包含已从中获取嵌入字体对象的 URL。

返回值

如果成功，则返回E_NONE。

*pulPrivStatus 引用的位置标识字体的嵌入权限。 *pulStatus 引用的位置标识是否嵌入了字体的子集。

否则， 将返回 Embedding-Function Error Messages 中所述的错误代码。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 t2embapi.h
Library T2embed.lib
DLL T2embed.dll

另请参阅

TTGetEmbeddingType

TTGetNewFontName

TTLOADINFO

TTLoadEmbeddedFont