IXpsOMPackage1：：WriteToFile1 方法 (xpsobjectmodel_1.h)

將 XPS OM 寫入檔案做為指定類型的 XPS 套件。

語法

HRESULT WriteToFile1(
  LPCWSTR               fileName,
  LPSECURITY_ATTRIBUTES securityAttributes,
  DWORD                 flagsAndAttributes,
  BOOL                  optimizeMarkupSize,
  XPS_DOCUMENT_TYPE     documentType
);

參數

fileName

[in， string]要建立的檔案名。 此參數不得為 Null。

securityAttributes

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

lpSecurityDescriptor：選擇性的安全性描述元

bInheritHandle：布林值，決定子進程是否可以繼承傳回的控制碼

如果 lpSecurityDescriptor 為 Null，則與傳回控制碼相關聯的檔案或裝置將會獲指派預設的安全性描述元。

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

flagsAndAttributes

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

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

optimizeMarkupSize

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

TRUE：封裝寫入器會嘗試優化最小大小的標記。

FALSE：封裝寫入器不會嘗試執行任何優化。

documentType

[in]要寫入 outputStream 的 XPS 資料格式。 這個參數的值不能XPS_DOCUMENT_TYPE_UNSPECIFIED。

傳回值

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

S_OK：方法成功。

E_POINTER：documentType 為 Null。

E_INVALIDARG：檔案類型已指定為XPS_DOCUMENT_TYPE_UNSPECIFIED。

XPS_E_INVALID_CONTENT_TYPE：套件中的影像資源屬於 documentType 中指定的檔案類型不支援的類型。

備註

呼叫端必須確定封裝類型支援封裝中的所有映射資源。 例如，JpegXR 影像無法用於 MSXPS 檔案類型，因為它們不相容。

規格需求

最低支援的用戶端	Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	xpsobjectmodel_1.h
程式庫	無

另請參閱

IXpsOMPackage1