Metode IStreamAsync::ReadAsync (shobjidl.h)

Artikel
03/02/2024

Membaca informasi dari aliran secara asinkron. Misalnya, Shell mengimplementasikan antarmuka ini pada item file saat mentransfernya secara asinkron.

Sintaks

HRESULT ReadAsync(
  [out]           void         *pv,
  [in]            DWORD        cb,
  [out, optional] LPDWORD      pcbRead,
  [in]            LPOVERLAPPED lpOverlapped
);

Parameter

[out] pv

Jenis: batal*

Ketika metode ini berhasil dikembalikan, mengembalikan buffer yang panjangnya cb byte dan berisi byte informasi pcbRead dari operasi baca.

[in] cb

Jenis: DWORD

Jumlah byte yang akan dibaca dari aliran.

[out, optional] pcbRead

Jenis: LPDWORD

Penunjuk ke nilai DWORD yang, ketika metode ini berhasil dikembalikan, menyatakan jumlah byte aktual yang dibaca ke buffer yang ditujukkan oleh pv. Nilai ini bisa NULL.

[in] lpOverlapped

Jenis: LPOVERLAPPED

Penunjuk ke struktur TUMPANG TINDIH yang berisi informasi yang digunakan dalam operasi baca asinkron.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

IStreamAsync::ReadAsync harus mengatur ulang peristiwa yang ditentukan oleh anggota hEvent dari struktur TUMPANG TINDIH ke status tidak bertanda ketika memulai operasi input/output (I/O).

Metode ini telah diterapkan di Shell sebagai pembungkus tipis di sekitar API ReadFile publik.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl.h

Bagikan melalui