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

Lee información de una secuencia de forma asincrónica. Por ejemplo, el Shell implementa esta interfaz en los elementos de archivo al transferirlos de forma asincrónica.

Sintaxis

HRESULT ReadAsync(
  [out]           void         *pv,
  [in]            DWORD        cb,
  [out, optional] LPDWORD      pcbRead,
  [in]            LPOVERLAPPED lpOverlapped
);

Parámetros

[out] pv

Tipo: void*

Cuando este método se devuelve correctamente, devuelve un búfer que es de bytes cb y contiene bytes pcbRead de información de la operación de lectura.

[in] cb

Tipo: DWORD

Número de bytes que se van a leer de la secuencia.

[out, optional] pcbRead

Tipo: LPDWORD

Puntero a un valor DWORD que, cuando este método devuelve correctamente, indica el número real de bytes leídos en el búfer al que apunta pv. Este valor puede ser NULL.

[in] lpOverlapped

Tipo: LPOVERLAPPED

Puntero a una estructura SUPERPUESTA que contiene información utilizada en la operación de lectura 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

IStreamAsync::ReadAsync debe restablecer el evento especificado por el miembro hEvent de la estructura SUPERPUESTA a un estado no asignado cuando inicia la operación de entrada/salida (E/S).

Este método se ha implementado en shell como un contenedor fino en torno a la API readFile pública.

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