IXpsOMGlyphs::GetGlyphMappings 方法 (xpsobjectmodel.h)

获取XPS_GLYPH_MAPPING结构的数组,这些结构描述如何将 UTF-16 标量值映射到由 GetGlyphIndices 返回的 XPS_GLYPH_INDEX 结构数组中的条目。

语法

HRESULT GetGlyphMappings(
  [in, out] UINT32            *glyphMappingCount,
  [in, out] XPS_GLYPH_MAPPING *glyphMappings
);

参数

[in, out] glyphMappingCount

将适合在 glyphMappings 引用的数组中的XPS_GLYPH_MAPPING结构的数目。 当方法返回时, glyphMappingCount 包含 glyphMappings 引用的数组中返回的值数。

[in, out] glyphMappings

包含字形映射值的 XPS_GLYPH_MAPPING 结构的数组。

返回值

该方法返回 HRESULT。 可能的值包括但不限于下表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息,请参阅 XPS 文档错误

返回代码 说明
S_OK
方法成功。
E_POINTER
glyphMappingCount 和/或 glyphMappings 均为 NULL
ERROR_MORE_DATA
glyphMappings 不够大,无法接收字形索引数据。 glyphMappingCount 包含所需数量的元素。

注解

GetGlyphMappingCount 获取字形映射的数目。

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 xpsobjectmodel.h

另请参阅

GetGlyphMappingCount

IXpsOMGlyphs

XML 纸张规范

XPS 文档错误

XPS_GLYPH_INDEX

XPS_GLYPH_MAPPING