Metode IOpcFactory::ReadPackageFromStream (msopc.h)

Artikel
03/05/2024

Mendeserialisasi data paket dari aliran dan membuat objek paket untuk mewakili paket yang sedang dibaca. Saat objek PACKaging API yang diperoleh dari objek paket, atau objek paket itu sendiri, masih digunakan, aliran dapat digunakan untuk mengakses data paket.

Sintaks

HRESULT ReadPackageFromStream(
  [in]          IStream        *stream,
  [in]          OPC_READ_FLAGS flags,
  [out, retval] IOpcPackage    **package
);

Parameter

[in] stream

Penunjuk ke antarmuka IStream aliran.

Aliran harus dapat dibaca, dicari, memiliki ukuran, dan harus berisi data paket. Selain itu, jika aliran tidak dapat dikloning, aliran akan di-buffer dan dibaca secara berurutan, menimbulkan overhead.

[in] flags

Nilai yang menentukan pengaturan baca untuk komponen paket penembolokan dan memvalidasinya terhadap persyaratan kesuaian OPC .

[out, retval] package

Penunjuk ke antarmuka IOpcPackage dari objek paket yang mewakili paket yang dibaca melalui aliran.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Nilai yang diteruskan dalam parameter bendera bukan nilai enumerasi OPC_READ_FLAGS yang valid.
E_NOTIMPL	Metode ini tidak diimplementasikan untuk versi Windows ini.
E_POINTER	Setidaknya salah satu parameter aliran dan paket adalah NULL.
Kesalahan antarmuka IStream	Kode kesalahan HRESULT dari antarmuka IStream .
Kesalahan Konsumsi Paket	Kode kesalahan HRESULT dari Grup Kesalahan Konsumsi Paket.
Kesalahan URI bagian	Kode kesalahan HRESULT dari Grup Kesalahan URI Bagian.

Keterangan

Jangan gunakan aliran untuk menserialisasikan data paket saat aliran yang sama digunakan untuk mendeserialisasi paket, karena upaya tersebut dapat mengakibatkan perilaku yang tidak terdefinisi.

API Pengemasan dapat berinteraksi dengan paket yang memetakan arsip ZIP seperti yang ditentukan dalam OPC, dan yang didasarkan pada pengodean Zip32 (ZIP 2.0) atau Zip64 (ZIP 4.5).

Untuk informasi tentang cara menggunakan metode ini untuk memuat paket, lihat tugas Memuat pemrograman Paket .

Dukungan pada Versi Windows Sebelumnya

Metode ini tidak didukung pada versi Windows sebelum Windows 7. Untuk informasi selengkapnya, lihat Mulai menggunakan API Kemasan, dan Pembaruan Platform untuk Windows Vista.

Keamanan Thread

Objek pengemasan tidak aman untuk rangkaian.

Untuk informasi selengkapnya, lihat Memulai API Kemasan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	msopc.h