IXpsOMObjectFactory：：CreateDocumentStructureResource 方法 (xpsobjectmodel.h)

發行項
12/22/2023

建立 IXpsOMDocumentStructureResource 介面，以提供檔結構資源資料流的存取權。

語法

HRESULT CreateDocumentStructureResource(
  [in]          IStream                         *acquiredStream,
  [in]          IOpcPartUri                     *partUri,
  [out, retval] IXpsOMDocumentStructureResource **documentStructureResource
);

參數

[in] acquiredStream

要與此資源相關聯的唯讀 IStream 介面。此參數不得為 Null。

重要將此資料流程視為 Single-Threaded Apartment (STA) 物件;請勿重新輸入。

[in] partUri

IOpcPartUri介面，其中包含要指派給此資源的元件名稱。此參數不得為 Null。

[out, retval] documentStructureResource

新 IXpsOMDocumentStructureResource 介面的指標。

傳回值

方法會傳回 HRESULT。可能的值包括下列資料表中的值，但不限於這些值。如需此表格中未列出的 XPS 檔 API 傳回值的相關資訊，請參閱 XPS 檔錯誤。

傳回碼	描述
S_OK	此方法已成功。
E_POINTER	acquiredStream、 partUri或 documentStructureResource 為 Null。

備註

XPS 檔的 DocumentStructure 部分包含檔大綱，其中 StoryFragments 元件會定義出現在檔固定頁面中之每個元素的讀取順序。這個介面可讓程式讀取 DocumentStructure 元件的 XML 內容，並取代 DocumentStructure 元件的 XML 內容。

DocumentStructure 元件包含檔架構和描述檔整體讀取順序的大綱。讀取順序會組織成稱為劇本的語意區塊。劇本是檔的邏輯單元，與文章在雜誌中的單位相同。劇本是由一或多個 StoryFragment 元件所組成。

StoryFragments 元件包含內容結構標記，可定義本文的語意區塊，例如構成本文內容的段落和資料表。

DocumentStructure 和 StoryFragments 元件的內容會在 XML 紙張規格中說明。

規格需求


最低支援的用戶端	適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	xpsobjectmodel.h