IXpsOMObjectFactory：：CreatePackageWriterOnStream 方法 (xpsobjectmodel.h)

發行項
03/05/2024

開啟數據流，將 XPS OM 的內容寫入至 XPS 套件。

語法

HRESULT CreatePackageWriterOnStream(
  [in]          ISequentialStream         *outputStream,
  [in]          BOOL                      optimizeMarkupSize,
  [in]          XPS_INTERLEAVING          interleaving,
  [in]          IOpcPartUri               *documentSequencePartName,
  [in]          IXpsOMCoreProperties      *coreProperties,
  [in]          IXpsOMImageResource       *packageThumbnail,
  [in]          IXpsOMPrintTicketResource *documentSequencePrintTicket,
  [in]          IOpcPartUri               *discardControlPartName,
  [out, retval] IXpsOMPackageWriter       **packageWriter
);

參數

[in] outputStream

要用於寫入的數據流。

[in] optimizeMarkupSize

布爾值，指出當檔寫入數據流時，文件標記是否會針對大小進行優化。

值	意義
真	寫入數據流時，封裝寫入器會嘗試優化最小大小的標記。
假	寫入封裝時，封裝寫入器不會嘗試任何優化。

[in] interleaving

指定將 XPS OM 的內容寫入資料流時是否交錯。

[in] documentSequencePartName

IOpcPartUri 介面，其中包含新檔案中檔順序的元件名稱。

[in] coreProperties

IXpsOMCoreProperties 介面，其中包含要提供給新檔案的核心文檔屬性。此參數可以設定為 NULL。

[in] packageThumbnail

IXpsOMImageResource 介面，其中包含要指派給新檔案的縮圖影像。此參數可以設定為 NULL。

[in] documentSequencePrintTicket

包含要指派給新檔案之套件層級列印票證的 IXpsOMPrintTicketResource 介面。此參數可以設定為 NULL。

[in] discardControlPartName

包含捨棄控件元件名稱的 IOpcPartUri 介面。此參數可以設定為 NULL。

[out, retval] packageWriter

這個方法所建立之新 IXpsOMPackageWriter 介面的指標。

傳回值

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

傳回碼	描述
S_OK	此方法已成功。
E_POINTER	outputStream、 documentSequencePartName 或 packageWriter 為 NULL。
XPS_E_NO_CUSTOM_OBJECTS	coreProperties、 documentSequencePrintTicket 或 packageThumbnail 不會指向可辨識的介面實作。不支援 XPS 檔 API 介面的自定義實作。

這個方法會呼叫封裝 API。如需封裝 API 傳回值的相關信息，請參閱封裝錯誤。

備註

數據流會開啟並初始化，然後會使用傳回的 IXpsOMPackageWriter 介面來撰寫內容類型、套件關聯性、核心屬性、檔順序資源和檔順序關聯性。

如果 documentSequencePrintTicket 設定為 NULL ，且交錯的值 XPS_INTERLEAVING_ON，此方法會建立空白作業層級的列印票證，並將關聯性新增至空白列印票證。這麼做是為了提供更有效率的串流耗用量套件。

如果 documentSequencePrintTicket 設定為 NULL ，且交錯的值 XPS_INTERLEAVING_OFF，則不會建立空白列印票證。

規格需求

需求	值
最低支援的用戶端	適用於 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