ISequentialStream::Metode baca (objidl.h)

Artikel
03/05/2024

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