開啟串流,將 XPS OM 的內容寫入指定型別的 XPS 套件。
語法
HRESULT CreatePackageWriterOnStream1(
ISequentialStream *outputStream,
BOOL optimizeMarkupSize,
XPS_INTERLEAVING interleaving,
IOpcPartUri *documentSequencePartName,
IXpsOMCoreProperties *coreProperties,
IXpsOMImageResource *packageThumbnail,
IXpsOMPrintTicketResource *documentSequencePrintTicket,
IOpcPartUri *discardControlPartName,
XPS_DOCUMENT_TYPE documentType,
IXpsOMPackageWriter **packageWriter
);
參數
outputStream
[在]用於寫作的串流。
optimizeMarkupSize
一個布林值,表示文件寫入串流時,標記是否會針對大小進行最佳化。
| 價值觀 | Meaning |
|---|---|
|
寫入串流時,封包撰寫者會嘗試將標記優化至最小大小。 |
|
寫入套件時,程式包撰寫者不會嘗試任何最佳化。 |
interleaving
[在]指定 XPS OM 的內容在寫入串流時是否會交錯。
documentSequencePartName
[在]包含新檔案中文件序列部分名稱的 IOpcPartUri 介面。
coreProperties
[在] IXpsOMCoreProperties 介面,包含將要賦予新檔案的核心文件屬性。 此參數可以設定為 NULL。
packageThumbnail
[在] IXpsOMImageResource 介面,包含要指派給新檔案的縮圖影像。 此參數可以設定為 NULL。
documentSequencePrintTicket
[在] IXpsOMPrintTicketResource 介面,包含待指派給新檔案的套件層級列印工單。 此參數可以設定為 NULL。
discardControlPartName
[在]包含丟棄控制元件名稱的 IOpcPartUri 介面。 此參數可以設定為 NULL。
documentType
[在]套件撰寫者的文件類型。 此參數的值無法XPS_DOCUMENT_TYPE_UNSPECIFIED。
packageWriter
[結束,回溯]這是指向此方法所建立的新 IXpsOMPackageWriter 介面的指標。
返回值
可能的數值包括但不限於以下幾項。 關於 XPS 文件 API 回傳值(未在此列出)的資訊,請參見 XPS 文件錯誤。
S_OK:方法成功了,packageWriter 也被正確設定。
E_INVALIDARG:該文件類型並非有效的 XPS 文件格式。
備註
使用此方法可產生 MSXPS 文件或 OpenXPS 文件的套件編譯器。 CreatePackageWriterOnStream 於 Windows 7 中發布,僅以 MSXPS 格式建立 XPS 文件檔案。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
| 目標平臺 | 窗戶 |
| Header | xpsobjectmodel_1.h |
| Library | None |