IXpsOMPackage：：WriteToFile 方法（xpsobjectmodel.h）

發行項
11/20/2024

將 XPS 套件寫入指定的檔案。

語法

HRESULT WriteToFile(
  [in] LPCWSTR               fileName,
  [in] LPSECURITY_ATTRIBUTES securityAttributes,
  [in] DWORD                 flagsAndAttributes,
  [in] BOOL                  optimizeMarkupSize
);

參數

[in] fileName

要建立的檔名。此參數不得 NULL。

[in] securityAttributes

SECURITY_ATTRIBUTES 結構，其中包含兩個相異但相關的數據成員：

lpSecurityDescriptor：選擇性的安全性描述元
bInheritHandle：布爾值，決定子進程是否可以繼承傳回的句柄

如果 lpSecurityDescriptorNULL，則與傳回句柄相關聯的檔案或裝置將會獲指派預設的安全性描述元。

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

[in] flagsAndAttributes

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

如需有關 flagsAndAttributes 參數的詳細資訊，請參閱 createFile。

[in] optimizeMarkupSize

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

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

傳回值

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

傳回碼	描述
S_OK	方法成功。
E_POINTER	fileNameNULL。

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

言論

optimizeMarkupSize 值會決定個別檔元件內的標記是否要優化。它不會影響零件交錯的方式。

注意將 XPS OM 寫入檔案不會自動建立 XPS 檔的縮圖。若要建立 XPS 檔的縮圖，請使用 IXpsOMThumbnailGenerator 介面。

要求

要求	價值
最低支援的用戶端	適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 \|UWP 應用程式]
支援的最低伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平臺	窗戶
標頭	xpsobjectmodel.h