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:布爾值,決定子進程是否可以繼承傳回的句柄
如需 securityAttributes 的詳細資訊,請參閱 CreateFile。
flagsAndAttributes
[in]指定要建立之檔案的設定和屬性。 對於大部分的檔案,可以使用 FILE_ATTRIBUTE_NORMAL 值。
如需此參數的詳細資訊,請參閱 CreateFile 。
optimizeMarkupSize
[in]布爾值,指出當 XPS OM 的內容寫入 XPS 套件時,檔標記是否會針對大小進行優化。
值 | 意義 |
---|---|
|
封裝寫入器會嘗試優化最小大小的標記。 |
|
封裝寫入器不會嘗試執行任何優化。 |
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 檔的封裝寫入器。 在 Windows 7 中發行的 CreatePackageWriterOnFile 只會以 MSXPS 格式建立 XPS 檔案檔案。
其他參考
其他參考:舊版方法描述規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | xpsobjectmodel_1.h |
程式庫 | 無 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應