XPS 文档错误

下表列出了 XPS 文档 API 方法可返回的所有 HRESULT 值。 请注意，并非每个方法都返回此表中列出的每个返回值。

返回代码/值	说明
XPS_E_ALREADY_OWNED 0x80520503	该接口已有所有者。
XPS_E_BLEED_BOX_PAGE_DIMENSIONS_NOT_IN_SYNC 0x80520509	流血框尺寸与页面尺寸不兼容。 流血框宽度值必须大于或等于页面宽度加上流血框原点的 x 坐标的绝对值。 流血框高度值必须大于或等于页面高度加上出血框原点的 y 坐标的绝对值。
XPS_E_BOTH_PATHFIGURE_AND_ABBR_SYNTAX_PRESENT 0x80520507	PathGeometry 元素包含一组使用 Figures 属性或子 PathFigure 元素指定的路径图。 几何图形的路径图不能同时具有 Figures 属性和子 PathFigure 元素。
XPS_E_BOTH_RESOURCE_AND_SOURCEATTR_PRESENT 0x80520508	一个 ResourceDictionary 元素，它在其 Source 属性中指定远程资源字典不得包含任何资源定义子元素。
XPS_E_CARET_OUT_OF_ORDER 0x80520306	插入点位置值无序。 位置值必须按升序排序。
XPS_E_CARET_OUTSIDE_STRING 0x80520305	为空字符串指定了插入点停止;或者，插入符号跳转索引已超过 Unicode 字符串的长度。
XPS_E_COLOR_COMPONENT_OUT_OF_RANGE 0x80520506	颜色值的范围不足。 对于 XPS_COLOR_TYPE_SCRGB 颜色类型，alpha 通道值必须大于或等于 0.0，并且小于或等于 +1.0。 对于 XPS_COLOR_TYPE_CONTEXT 颜色类型，表示 alpha 通道值的 channelValues[0] 必须大于或等于 0.0 且小于或等于 +1.0。
XPS_E_DICTIONARY_ITEM_NAMED 0x80520401	资源字典中的视觉对象具有 Name 属性，该属性可能未在 ResourceDictionary 元素的任何子级上指定。
XPS_E_DUPLICATE_NAMES 0x80520209	字典中已存在具有此名称的对象。
XPS_E_DUPLICATE_RESOURCE_KEYS 0x80520200	字典中已存在具有此键名称的对象。
XPS_E_INDEX_OUT_OF_RANGE 0x80520500	保留。
XPS_E_INVALID_BLEED_BOX 0x80520004	流血框矩形包含一个或多个无效值。 请参阅有效值的参数说明。
XPS_E_INVALID_CONTENT_BOX 0x8052000b	内容框矩形包含一个或多个无效值。 请参阅有效值的参数说明。
XPS_E_INVALID_CONTENT_TYPE 0x8052000e	内容类型字符串无效。
XPS_E_INVALID_FLOAT 0x80520007	FLOAT 值无效。 它要么是无限的，要么不是数字（NAN）。
XPS_E_INVALID_FONT_URI 0x8052000a	字体 URI 无效，可能是因为它包含无效的空片段或字符。
XPS_E_INVALID_LANGUAGE 0x80520000	指定的语言无效或格式不正确。
XPS_E_INVALID_LOOKUP_TYPE 0x80520006	查找键名称引用的对象不是调用的正确类型;例如，如果该方法返回画笔，但查找键名称引用几何图形对象。
XPS_E_INVALID_MARKUP 0x8052000c	要读取的标记包含不符合 XML 纸张规范的元素或属性。 注意： 若要表示浮点值，XPS OM 使用 FLOAT 数据类型而不是 DOUBLE。 如果 XPS 文档具有一个不适应 FLOAT 值的浮点数据的元素，则当反序列化期间遇到该值时，将返回此错误。
XPS_E_INVALID_NAME 0x80520001	根据 XML 纸张规范，传递的字符串不是有效的名称。
XPS_E_INVALID_OBFUSCATED_FONT_URI 0x8052000f	保留。
XPS_E_INVALID_PAGE_SIZE 0x80520003	页面维度包含无效的页面大小值。
XPS_E_INVALID_RESOURCE_KEY 0x80520002	根据 XML 纸张规范，查找键字符串无效。
XPS_E_INVALID_THUMBNAIL_IMAGE_TYPE 0x80520005	不支持缩略图图像类型。
XPS_E_INVALID_XML_ENCODING 0x8052000d	发现错误或格式不正确的 XML 标记。
XPS_E_MAPPING_OUT_OF_ORDER 0x80520302	在一个或多个 XPS_GLYPH_MAPPING 结构中，元素不按顺序排列。
XPS_E_MAPPING_OUTSIDE_INDICES 0x80520304	字形映射超过了字形索引的数量。
XPS_E_MAPPING_OUTSIDE_STRING 0x80520303	字形映射中的错误。 如果 Unicode 字符串为空，则此错误表示还定义了字形映射。 如果 Unicode 字符串为空，则不得定义字形映射。 如果 Unicode 字符串不为空，则此错误表示为 Unicode 字符串外部的字形定义字形映射。 不能为超出 Unicode 字符串长度的字形定义字形映射。
XPS_E_MISSING_COLORPROFILE 0x80520104	颜色配置文件参数为 NULL，但预期有颜色配置文件。 当颜色类型XPS_COLOR_TYPE_CONTEXT时，需要颜色配置文件。
XPS_E_MISSING_DISCARDCONTROL 0x80520112	页面引用可丢弃的资源，但不指定 DiscardControl 部件名称。
XPS_E_MISSING_DOCUMENT 0x80520109	IXpsOMPackageWriter：：AddPage 在 IXpsOMPackageWriter：：StartNewDocument 之前调用。
XPS_E_MISSING_DOCUMENTSEQUENCE_RELATIONSHIP 0x80520108	包不包含 FixedDocumentSequence。
XPS_E_MISSING_FONTURI 0x80520107	IXpsOMGlyphs 接口需要字体 URI，但未指定字体 URI。
XPS_E_MISSING_GLYPHS 0x80520102	没有 Unicode 字符串的 IXpsOMGlyphs 接口未指定任何字形索引。 IXpsOMGlyphs 接口必须指定 Unicode 字符串或字形索引数组。
XPS_E_MISSING_IMAGE_IN_IMAGEBRUSH 0x8052010e	无法为图像画笔找到图像资源。
XPS_E_MISSING_LOOKUP 0x80520101	远程资源具有意外的对象。
XPS_E_MISSING_NAME 0x80520100	页面尚未命名;仅当页面具有名称时，才能设置超链接目标状态。
XPS_E_MISSING_PAGE_IN_DOCUMENT 0x8052010c	FixedDocument 不包含任何 FixedPage 部件。 XPS 文档必须至少包含一个 FixedPage 部件。
XPS_E_MISSING_PAGE_IN_PAGEREFERENCE 0x8052010d	页面引用没有相应的页面。
XPS_E_MISSING_PART_REFERENCE 0x80520110	未引用所需的目标部件。
XPS_E_MISSING_PART_STREAM 0x80520113	未为资源指定流。
XPS_E_MISSING_REFERRED_DOCUMENT 0x8052010a	找不到 FixedDocumentSequence 引用的 FixedDocument 部件。 XPS 文档必须至少包含一个 FixedDocument。
XPS_E_MISSING_REFERRED_PAGE 0x8052010b	找不到 FixedDocument 引用的 FixedPage 部件。 XPS 文档必须至少包含一个 FixedPage 部件。
XPS_E_MISSING_RELATIONSHIP_TARGET 0x80520105	包关系中不存在关系目标部件。
XPS_E_MISSING_RESOURCE_KEY 0x8052010f	未为资源指定 x：Key 属性。
XPS_E_MISSING_RESOURCE_RELATIONSHIP 0x80520106	页面或远程字典内容引用的资源不存在为页面关系。
XPS_E_MISSING_RESTRICTED_FONT_RELATIONSHIP 0x80520111	对 IXpsOMPackageWriter：：StartNewDocument 的调用中未指定引用的受限字体。
XPS_E_MISSING_SEGMENT_DATA 0x80520103	段数据数组的条目数少于段类型数组。
XPS_E_MULTIPLE_DOCUMENTSEQUENCE_RELATIONSHIPS 0x80520202	尝试将 FixedDocumentSequence 添加到已有的包。 XPS 文档必须包含一个和只有一个 FixedDocumentSequence 部件。
XPS_E_MULTIPLE_PRINTTICKETS_ON_DOCUMENT 0x80520206	尝试将文档级打印票证添加到已具有文档级打印票证的 FixedDocument。 XPS 文档中的 FixedDocument 只能包含一个文档级打印票证。
XPS_E_MULTIPLE_PRINTTICKETS_ON_DOCUMENTSEQUENCE 0x80520207	尝试将作业级打印票证添加到已具有作业级别的打印票证的 FixedDocumentSequence。 XPS 文档中的 FixedDocumentSequence 只能包含一个作业级打印票证。
XPS_E_MULTIPLE_PRINTTICKETS_ON_PAGE 0x80520205	尝试将页面级打印票证添加到已具有页的 FixedPage。 XPS 文档中的 FixedPage 只能包含一个页面级打印票证。
XPS_E_MULTIPLE_REFERENCES_TO_PART 0x80520208	受限字体集合包含重复的受限字体条目。 每个字体条目只能出现在集合中一次。
XPS_E_MULTIPLE_RESOURCES 0x80520201	该部分名称的资源已存在。
XPS_E_MULTIPLE_THUMBNAILS_ON_PACKAGE 0x80520204	尝试将缩略图图像添加到已有缩略图的包。 XPS 文档只能包含一个包级缩略图。
XPS_E_MULTIPLE_THUMBNAILS_ON_PAGE 0x80520203	尝试将页面级缩略图添加到已具有页的 FixedPage。 XPS 文档中的 FixedPage 只能包含一个页面级缩略图。
XPS_E_NEGATIVE_FLOAT 0x8052030a	条目包含负值，但它必须包含非负值。
XPS_E_NESTED_REMOTE_DICTIONARY 0x80520402	尝试向远程字典添加远程字典引用。 远程字典不能引用另一个远程词典。
XPS_E_NO_CUSTOM_OBJECTS 0x80520502	接口指针不指向已识别的接口实现。 不支持 XPS 文档 API 接口的自定义实现。
XPS_E_NOT_ENOUGH_GRADIENT_STOPS 0x8052050b	渐变停止点集合的停止点数少于两个停止点。 渐变停止点集合必须至少有两个渐变停止点。
XPS_E_ODD_BIDILEVEL 0x80520307	文本字符串被指定为方向侧向和从右向左。 如果文本面向侧向，则不能有一个奇数值（从右到左）的 bidi 级别。 同样，如果 bidi 级别是奇数值，则文本不能侧向。
XPS_E_ONE_TO_ONE_MAPPING_EXPECTED 0x80520308	字形映射与 Unicode 字符串内容不匹配。
XPS_E_PACKAGE_WRITER_NOT_CLOSED 0x8052050c	包编写器在发布之前未关闭。
XPS_E_RELATIONSHIP_EXTERNAL 0x8052050a	关系是指 XPS 文档外部的部件。 要在 XPS 文档中呈现的所有内容都必须包含在 XPS 文档中。
XPS_E_RESOURCE_NOT_OWNED 0x80520504	保留。
XPS_E_RESTRICTED_FONT_NOT_OBFUSCATED 0x80520309	保留。
XPS_E_STRING_TOO_LONG 0x80520300	尝试将字符串复制到新缓冲区期间发生 size_t 溢出。
XPS_E_TOO_MANY_INDICES 0x80520301	比 Unicode 码位更多的字形索引。 如果没有字形映射，字形索引的数量必须小于或等于 Unicode 码位的数目。
XPS_E_UNAVAILABLE_PACKAGE 0x80520114	发生严重错误，并且 XPS OM 的内容可能无法恢复。 XPS OM 的某些组件可能仍然可用，但需在进一步使用之前对其进行验证。 由于返回此错误后无法预测 XPS OM 的状态，因此应释放并丢弃 XPS OM 的所有组件。
XPS_E_UNEXPECTED_COLORPROFILE 0x80520505	当一个不预期时，存在颜色配置文件。 仅当颜色类型 XPS_COLOR_TYPE_CONTEXT时，才允许使用颜色配置文件。
XPS_E_UNEXPECTED_CONTENT_TYPE 0x80520008	关系的目标不是关系上下文预期的类型。
XPS_E_UNEXPECTED_RELATIONSHIP_TYPE 0x80520010	无法识别关系类型。
XPS_E_UNEXPECTED_RESTRICTED_FONT_RELATIONSHIP 0x80520011	受限字体集合包含不受限制的字体。
XPS_E_VISUAL_CIRCULAR_REF 0x80520501	保留。
XPS_E_XKEY_ATTR_PRESENT_OUTSIDE_RES_DICT 0x80520400	不在资源字典中的路径几何图形指定 了 x：Key 属性。 不在资源字典中的路径几何图形不能具有 x：Key 属性。

注解

某些 XPS 文档 API 方法调用 打包 API。 有关打包 API 返回值的信息，请参阅 “打包错误”。

要求

要求	价值
支持的最低客户端	适用于 Windows Vista 的 Windows 7、带有 SP2 和平台更新的 Windows Vista [仅限桌面应用]
支持的最低服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [仅限桌面应用]
标题	Xpsobjectmodel.h
IDL	XpsObjectModel.idl

另请参阅

COM 中的 错误处理