IStreamAsync::WriteAsync メソッド (shobjidl.h)

ストリームに非同期的に情報を書き込みます。たとえば、シェルは、非同期的に転送するときに、ファイル項目にこのメソッドを実装します。

構文

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

非同期書き込み操作で使用される情報を含む OVERLAPPED 構造体へのポインター。

型: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

WriteAsync は、入出力 (I/O) 操作を開始するときに、OVERLAPPED 構造体の hEvent メンバーによって指定されたイベントを非署名状態にリセットする必要があります。