Bagikan melalui


ISequentialStream::Metode baca (objidl.h)

Metode Baca membaca jumlah byte tertentu dari objek aliran ke dalam memori, dimulai dari penunjuk pencarian saat ini.

Sintaks

HRESULT Read(
  [out] void  *pv,
  [in]  ULONG cb,
  [out] ULONG *pcbRead
);

Parameter

[out] pv

Penunjuk ke buffer tempat data aliran dibaca.

[in] cb

Jumlah byte data yang akan dibaca dari objek stream.

[out] pcbRead

Pointer ke variabel ULONG yang menerima jumlah byte aktual yang dibaca dari objek stream.

Catatan Jumlah byte yang dibaca mungkin nol.
 

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK Semua data yang diminta berhasil dibaca dari objek stream; jumlah byte yang diminta dalam cb sama dengan jumlah byte yang dikembalikan dalam pcbRead.
S_FALSE Nilai yang dikembalikan dalam pcbRead kurang dari jumlah byte yang diminta dalam cb. Ini menunjukkan akhir aliran telah tercapai. Jumlah byte yang dibaca menunjukkan berapa banyak buffer pv yang telah diisi.
E_PENDING Hanya penyimpanan asinkron: Sebagian atau semua data yang akan dibaca saat ini tidak tersedia.
STG_E_ACCESSDENIED Pemanggil tidak memiliki izin yang diperlukan untuk membaca objek aliran ini.
STG_E_INVALIDPOINTER Salah satu nilai pointer tidak valid.
STG_E_REVERTED Objek tidak valid oleh operasi kembali di atasnya di pohon transaksi.

Keterangan

Metode ini membaca byte dari objek aliran ini ke dalam memori. Objek stream harus dibuka dalam mode STGM_READ . Metode ini menyesuaikan penunjuk pencarian dengan jumlah byte aktual yang dibaca.

Jumlah byte yang benar-benar dibaca juga dikembalikan dalam parameter pcbRead .

Catatan untuk Penelepon

Jumlah aktual byte yang dibaca dapat kurang dari jumlah byte yang diminta jika terjadi kesalahan atau jika akhir aliran tercapai selama operasi baca. Jumlah byte yang dikembalikan harus selalu dibandingkan dengan jumlah byte yang diminta. Jika jumlah byte yang dikembalikan kurang dari jumlah byte yang diminta, biasanya berarti metode Baca yang mencoba membaca melewati akhir aliran.

Aplikasi harus menangani kesalahan yang dikembalikan dan S_OK mengembalikan nilai pada operasi baca akhir aliran.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header objidl.h
Pustaka Uuid.lib
DLL Ole32.dll

Lihat juga

ISequentialStream::Write

IStorage::OpenStream

IStream

IStream - Implementasi File Gabungan

STGMOVE