fungsi IStream_Read (shlwapi.h)

Membaca byte dari aliran tertentu dan mengembalikan nilai yang menunjukkan apakah semua byte berhasil dibaca.

Sintaks

LWSTDAPI IStream_Read(
  [in]  IStream *pstm,
  [out] void    *pv,
  [in]  ULONG   cb
);

Parameter

[in] pstm

Jenis: IStream*

Penunjuk ke antarmuka IStream aliran untuk dibaca.

[out] pv

Jenis: VOID*

Penunjuk ke buffer untuk menerima data aliran dari pstm. Buffer ini harus berukuran minimal cb byte.

[in] cb

Jenis: ULONG

Jumlah byte data yang harus dicoba oleh fungsi untuk membaca dari aliran input.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika fungsi berhasil membaca jumlah byte yang ditentukan dari aliran, atau kode kegagalan COM sebaliknya. Secara khusus, jika upaya baca berhasil tetapi kurang dari byte cb dibaca, fungsi mengembalikan E_FAIL.

Keterangan

Fungsi ini memanggil metode ISequentialStream::Read untuk membaca data dari aliran yang ditentukan ke dalam buffer. Jika fungsi gagal karena alasan apa pun, konten buffer output dan posisi penunjuk baca di aliran input tidak terdefinisi.

Persyaratan

Lihat juga

ISequentialStream::Read