Metode IXpsOMObjectFactory::CreatePackageFromFile (xpsobjectmodel.h)
Membuka file paket XPS dan mengembalikan pohon objek dokumen XPS yang diinstansiasi.
Sintaks
HRESULT CreatePackageFromFile(
[in] LPCWSTR filename,
[in] BOOL reuseObjects,
[out, retval] IXpsOMPackage **package
);
Parameter
[in] filename
Nama file paket XPS.
[in] reuseObjects
Nilai Boolean yang menunjukkan apakah perangkat lunak berupaya mengoptimalkan pohon objek dokumen dengan berbagi objek yang identik di semua properti dan turunan.
Nilai | Makna |
---|---|
|
Perangkat lunak akan mencoba mengoptimalkan pohon objek. |
|
Perangkat lunak tidak akan mencoba mengoptimalkan pohon objek. |
[out, retval] package
Penunjuk ke antarmuka IXpsOMPackage baru yang berisi pohon objek dokumen XPS yang dihasilkan.
Menampilkan nilai
Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk informasi tentang nilai pengembalian API dokumen XPS yang tidak tercantum dalam tabel ini, lihat Kesalahan Dokumen XPS.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil. |
|
nama file atau paket adalah NULL. |
Metode ini memanggil PACKAGING API. Untuk informasi tentang nilai pengembalian PACKAGING API, lihat Kesalahan Pengemasan.
Keterangan
Metode ini tidak memvalidasi konten sumber daya berbasis aliran apa pun yang dimuatnya dari aliran ke objek OM XPS. Sebagai gantinya, aplikasi harus memvalidasi sumber daya ini sebelum menggunakannya.
Metode ini tidak mendeserialisasi halaman dokumen; ini hanya mendeserialisasi paket XPS ke bagian referensi halaman. Halaman aktual dapat dideserialisasi sesuai kebutuhan, dengan memanggil metode IXpsOMPageReference::GetPage . Karena halaman tidak dideserialisasi ketika GetPage dipanggil, metode ini mungkin untuk mengembalikan S_OK atau, jika upaya dilakukan untuk memuat halaman bermasalah dalam paket XPS, untuk mengembalikan kesalahan.
Jika Anda menulis XPS OM segera setelah Anda membaca paket XPS ke dalamnya, beberapa konten asli mungkin hilang atau diubah.
Beberapa perubahan yang dapat terjadi dalam kasus seperti itu tercantum dalam tabel yang mengikuti:
Fitur dokumen | Tindakan |
---|---|
Tanda tangan digital | Dihapus dari dokumen |
Bagian DiscardControl | Dihapus dari dokumen |
Bagian dokumen asing | Dihapus dari dokumen |
Markup FixedPage | Dimodifikasi dari aslinya |
Markup kamus sumber daya | Dimodifikasi dari asli jika bendera Pengoptimalan diatur |
Untuk informasi tentang menggunakan antarmuka IXpsOMPackage dalam program, lihat Membuat OM XPS Kosong.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | xpsobjectmodel.h |