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는 INPUT/output(I/O) 작업을 시작할 때 OVERLAPPED 구조체의 hEvent 멤버가 지정한 이벤트를 서명되지 않은 상태로 다시 설정해야 합니다.