IXpsOMObjectFactory::CreatePackageFromStream method (xpsobjectmodel.h)

Artikel
12/22/2023

Membuka aliran yang berisi paket XPS, dan mengembalikan pohon objek dokumen XPS yang dibuat instans.

Sintaks

HRESULT CreatePackageFromStream(
  [in]          IStream       *stream,
  [in]          BOOL          reuseObjects,
  [out, retval] IXpsOMPackage **package
);

Parameter

[in] stream

Aliran yang berisi paket XPS.

[in] reuseObjects

Nilai Boolean yang menunjukkan bahwa perangkat lunak adalah mencoba mengoptimalkan pohon objek dokumen dengan berbagi objek yang identik di semua properti dan anak-anak.

Nilai	Makna
BENAR	Perangkat lunak akan mencoba mengoptimalkan pohon objek.
SALAH	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
S_OK	Metode berhasil.
E_POINTER	stream 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