共用方式為

IXpsOMObjectFactory1：：CreatePackageWriterOnFile1 方法 （xpsobjectmodel_1.h）

  • 發行項

開啟檔案，將 XPS OM 的內容寫入指定類型的 XPS 套件。 這個方法會產生 MSXPS 檔或 OpenXPS 檔的封裝寫入器。

語法

HRESULT CreatePackageWriterOnFile1(
  LPCWSTR                   fileName,
  LPSECURITY_ATTRIBUTES     securityAttributes,
  DWORD                     flagsAndAttributes,
  BOOL                      optimizeMarkupSize,
  XPS_INTERLEAVING          interleaving,
  IOpcPartUri               *documentSequencePartName,
  IXpsOMCoreProperties      *coreProperties,
  IXpsOMImageResource       *packageThumbnail,
  IXpsOMPrintTicketResource *documentSequencePrintTicket,
  IOpcPartUri               *discardControlPartName,
  XPS_DOCUMENT_TYPE         documentType,
  IXpsOMPackageWriter       **packageWriter
);

參數

fileName

[in]要建立的檔名。

securityAttributes

[in， unique]SECURITY_ATTRIBUTES 結構，其中包含兩個不同的但相關的成員：

  • lpSecurityDescriptor：選擇性的安全性描述元
  • bInheritHandle：布爾值，決定子進程是否可以繼承傳回的句柄
如果 lpSecurityDescriptorNULL，則會將與傳回句柄相關聯的檔案或裝置指派為預設的安全性描述元。

如需 securityAttributes的詳細資訊，請參閱 CreateFile。

flagsAndAttributes

[in]指定要建立之檔案的設定和屬性。 對於大部分的檔案，可以使用 FILE_ATTRIBUTE_NORMAL 值。

如需此參數的詳細資訊，請參閱 CreateFile。

optimizeMarkupSize

[in]布爾值，指出當 XPS OM 的內容寫入 XPS 套件時，檔標記是否會針對大小進行優化。

價值 意義
TRUE
 封裝寫入器會嘗試優化最小大小的標記。
FALSE
 封裝寫入器不會嘗試執行任何優化。

interleaving

[in]指定將 XPS OM 的內容寫入檔案時，是否交錯。

documentSequencePartName

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

coreProperties

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

packageThumbnail

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

documentSequencePrintTicket

[in]IXpsOMPrintTicketResource 介面，其中包含要指派給新檔案的套件層級列印票證。 這個參數可以設定為 NULL。

discardControlPartName

[in]IOpcPartUri 介面，其中包含捨棄控件元件的名稱。 這個參數可以設定為 NULL。

documentType

[in]指定封裝寫入器的檔案類型。 這個參數的值不能XPS_DOCUMENT_TYPE_UNSPECIFIED。

packageWriter

[out， retval]這個方法所建立之新 IXpsOMPackageWriter 介面的指標。

傳回值

可能的值包括，但不限於下列專案。 如需此處未列出的 XPS 檔 API 傳回值的相關信息，請參閱 XPS 檔錯誤。

S_OK：方法成功且 packageWriter 已正確設定。

E_INVALIDARG：檔案類型不是有效的 XPS 檔案格式。

言論

使用這個方法來產生 MSXPS 檔或 OpenXPS 檔的封裝寫入器。 CreatePackageWriterOnFile，在 Windows 7 中發行，只會以 MSXPS 格式建立 XPS 文件檔。

其他參考

其他參考：舊版方法描述

要求

要求 價值
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平臺 窗戶
標頭 xpsobjectmodel_1.h
連結庫 沒有

另請參閱

IXpsOMObjectFactory1