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	在 Source 属性中指定远程资源字典的 ResourceDictionary 元素不得包含任何资源定义子级。
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 颜色类型， channelValues[0] 表示 alpha 通道值必须大于或等于 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，但未指定。
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	文本字符串被指定为侧向和从右向左。 如果文本为侧向，则它不能有奇数值的双向级别（从右到左）。 同样，如果双向级别是奇数值，则文本不能侧向。
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 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [仅桌面应用]
最低受支持的服务器	Windows Server 2008 R2、带 SP2 的 Windows Server 和适用于 Windows Server 2008 的平台更新 [仅桌面应用]
Header	Xpsobjectmodel.h
IDL	XpsObjectModel.idl

另请参阅

COM 中的错误处理