IAppxFile::Metode GetStream (appxpackaging.h)

Mendapatkan aliran baca-saja yang berisi konten file yang tidak dikompresi.

Sintaks

HRESULT GetStream(
  [out, retval] IStream **stream
);

Parameter

[out, retval] stream

Jenis: IStream**

Aliran baca-saja yang berisi konten file yang tidak dikompresi.

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, metode akan mengembalikan S_OK.

[Fatal] Kode kesalahan OPC (0x8051xxxx) jika header file lokal file atau deskriptor data dalam arsip zip tidak valid. Kegagalan ini menyebabkan seluruh konsumen zip OPC memasuki status tidak valid, tidak ada file lain yang dapat diakses dari objek IAppxPackageReader setelah kesalahan ini terjadi.

HRESULT_FROM_WIN32(ERROR_CRC) (0x80070017) jika aliran sebelumnya telah dibaca dan CRC-nya tidak valid.

Mengembalikan nilai dari metode Read and CopyTo IStream yang dikembalikan

[Fatal] HRESULT_FROM_WIN32(ERROR_CRC) (0x80070017) jika seluruh aliran telah dibaca dan CRC-nya dianggap tidak valid

APPX_E_CORRUPT_CONTENT (0x80080206) jika konten file tidak dapat didekompresi (karena kerusakan file zip)

HRESULT_FROM_WIN32(ERROR_INVALID_DATA) (0x8007000d) jika blok dalam file tidak dapat dibaca sepenuhnya atau ukuran blok tidak terduga

APPX_E_BLOCK_HASH_INVALID (0x80080207) jika konten blok file ini tidak konsisten dengan hash-nya di peta blok

Keterangan

Aliran yang dikembalikan bersifat baca-saja dan dapat dikloning.

Validasi file payload adalah "malas." Pada panggilan pertama ke metode GetStream file, header file file zip dan pendeskripsi data lokal yang sesuai divalidasi dan dapat menyebabkan GetStream gagal. Panggilan berikutnya ke GetStream pada file yang sama tidak mengulangi validasi ini. Checksum CRC item file zip hanya divalidasi jika aliran dibaca secara keseluruhan dalam urutan berurutan.

Instans IStream yang dikembalikan untuk file payload dioptimalkan untuk akses berurutan. Meskipun akses acak ke aliran didukung, akses acak tersebut mungkin lebih lambat dan lebih intensif CPU. Kami merekomendasikan satu bacaan berurutan dari aliran ini jika memungkinkan. Membaca rentang yang sama beberapa kali didukung tetapi tidak disarankan untuk performa; pertimbangkan untuk melakukan penembolokan rentang tersebut jika skenario penggunaannya menuntutnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	appxpackaging.h

Lihat juga

IAppxFile

IAppxPackageReader