XPS 檔錯誤

發行項
10/20/2023

下表列出 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 元素指定的路徑圖。 geometry 的路徑圖形不能同時有 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	查閱索引鍵名稱參考的物件，該物件不是呼叫的正確類型;例如，如果方法傳回筆刷，但查閱索引鍵名稱會參考 geometry 物件。
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、Windows Vista SP2 和平臺更新 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [僅限傳統型應用程式]
標題	Xpsobjectmodel.h
IDL	XpsObjectModel.idl

另請參閱

COM 中的錯誤處理

共用方式為

XPS 檔錯誤

備註

需求

另請參閱

意見反應

其他資源