fungsi IStream_Read (shlwapi.h)

  • Artikel

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

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server, Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header shlwapi.h
DLL Shlwapi.dll (versi 5.0 atau yang lebih baru)

Lihat juga

ISequentialStream::Read