Método IStreamAsync::WriteAsync (shobjidl.h)

Escribe información en una secuencia de forma asincrónica. Por ejemplo, shell implementa este método en elementos de archivo al transferirlos de forma asincrónica.

Sintaxis

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

Parámetros

[in] lpBuffer

Tipo: const void*

Puntero a un búfer de tamaño cb bytes que contiene la información que se va a escribir en la secuencia.

[in] cb

Tipo: DWORD

Tamaño del búfer al que apunta lpBuffer, en bytes.

[out] pcbWritten

Tipo: LPDWORD

Puntero a un valor DWORD que, cuando el método devuelve correctamente, indica el número real de bytes escritos en la secuencia. Este valor puede ser NULL si no se necesita esta información.

[in] lpOverlapped

Tipo: LPOVERLAPPED

Puntero a una estructura SUPERPUESTA que contiene información utilizada en la operación de escritura asincrónica.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

WriteAsync debe restablecer el evento especificado por el miembro hEvent de la estructura SUPERPUESTA en un estado no asignado cuando comienza la operación de entrada/salida (E/S).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl.h