IStreamAsync：：WriteAsync 方法 (shobjidl.h)

以異步方式將資訊寫入數據流。例如，Shell 會在以異步方式傳輸檔案專案時，在檔案項目上實作這個方法。

語法

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

[in] lpBuffer

類型： const void*

大小 cb 位元組之緩衝區的指標，其中包含要寫入數據流的資訊。

[in] cb

類型： DWORD

由 lpBuffer 指向的緩衝區大小，以位元組為單位。

[out] pcbWritten

類型： LPDWORD

DWORD 值的指標，當方法成功傳回時，會指出寫入數據流的實際位元組數目。如果不需要此資訊，這個值可以是 NULL 。

[in] lpOverlapped

類型： LPOVERLAPPED

重迭結構的指標，其中包含異步寫入作業中使用的資訊。

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

當重疊結構的 hEvent 成員開始輸入/輸出 (I/O) 作業時，WriteAsync 應該會將重疊結構的 hEvent 成員所指定的事件重設為非簽署狀態。