Metode IStreamAsync::WriteAsync (shobjidl.h)

Artikel
03/02/2024

Menulis informasi ke aliran secara asinkron. Misalnya, Shell menerapkan metode ini pada item file saat mentransfernya secara asinkron.

Sintaks

HRESULT WriteAsync(
  [in]  const void   *lpBuffer,
  [in]  DWORD        cb,
  [out] LPDWORD      pcbWritten,
  [in]  LPOVERLAPPED lpOverlapped
);

Parameter

[in] lpBuffer

Jenis: const void*

Penunjuk ke buffer ukuran cb byte yang berisi informasi yang akan ditulis ke aliran.

[in] cb

Jenis: DWORD

Ukuran buffer yang diacu oleh lpBuffer, dalam byte.

[out] pcbWritten

Jenis: LPDWORD

Penunjuk ke nilai DWORD yang, ketika metode berhasil dikembalikan, menyatakan jumlah byte aktual yang ditulis ke aliran. Nilai ini bisa NULL jika informasi ini tidak diperlukan.

[in] lpOverlapped

Jenis: LPOVERLAPPED

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

Nilai kembali

Jenis: HRESULT

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

Keterangan

WriteAsync harus mengatur ulang peristiwa yang ditentukan oleh anggota hEvent dari struktur TUMPANG TINDIH ke status tidak ditandatangani saat memulai operasi input/output (I/O).

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