IXpsOMObjectFactory1::CreatePackageFromFile1 方法 (xpsobjectmodel_1.h)
開啟 XPS 套件檔案,並傳回具現化的 XPS 檔物件樹狀結構。 此方法會讀取檔案,其中包含類型為 XPS XPS_DOCUMENT_TYPE_ XPS 或 OPENXPS XPS_DOCUMENT_TYPE_的 XPS 檔
語法
HRESULT CreatePackageFromFile1(
LPCWSTR filename,
BOOL reuseObjects,
IXpsOMPackage1 **package
);
參數
filename
[in, string]XPS 封裝檔案的名稱。
reuseObjects
[in]布爾值,指出軟體嘗試藉由共用所有屬性和子系中完全相同的物件,來優化檔物件樹狀結構。
TRUE:軟體會嘗試優化物件樹狀結構。
FALSE:軟體不會嘗試優化物件樹狀結構。
package
[out, retval]新 IXpsOMPackage1 介面的指標,其中包含從檔名讀取的 XPS 檔物件樹狀結構。
傳回值
此方法會傳回 HRESULT。 可能的值包括,但不限於下列各項。 如需此處未列出的 XPS 檔 API 傳回值的相關信息,請參閱 XPS 檔錯誤。
S_OK:方法成功。
XPS_E_UNEXPECTED_NAMESPACE:封裝標記會使用檔類型不支援的命名空間
XPS_E_ABSOLUTE_REFERENCE:OpenXPS 檔包含 XML 元素,這些元素會使用絕對 URI 來參考檔中的其他部分。
備註
使用這個方法可讀取包含 XPS 檔案類型的檔案,該檔可以是XPS_DOCUMENT_TYPE_ XPS 類型,或XPS_DOCUMENT_TYPE_ OPENXPS。 在 Windows 7 中發行的 CreatePackageFromFile 只會開啟包含 XPS 檔類型XPS_DOCUMENT_TYPE_ XPS 的檔案。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | xpsobjectmodel_1.h |
程式庫 | 無 |