función IStream_Read (shlwapi.h)
Lee bytes de una secuencia especificada y devuelve un valor que indica si todos los bytes se leyeron correctamente.
Sintaxis
LWSTDAPI IStream_Read(
[in] IStream *pstm,
[out] void *pv,
[in] ULONG cb
);
Parámetros
[in] pstm
Tipo: IStream*
Puntero a la interfaz IStream de la secuencia desde la que se va a leer.
[out] pv
Tipo: VOID*
Puntero a un búfer para recibir los datos de flujo de pstm. Este búfer debe tener al menos bytes cb de tamaño.
[in] cb
Tipo: ULONG
Número de bytes de datos que la función debe intentar leer desde el flujo de entrada.
Valor devuelto
Tipo: HRESULT
Devuelve S_OK si la función lee correctamente el número especificado de bytes de la secuencia o un código de error COM en caso contrario. En concreto, si el intento de lectura se realizó correctamente pero se leyeron menos de bytes cb , la función devuelve E_FAIL.
Comentarios
Esta función llama al método ISequentialStream::Read para leer datos de la secuencia especificada en el búfer. Si se produce un error en la función por cualquier motivo, el contenido del búfer de salida y la posición del puntero de lectura en el flujo de entrada no están definidos.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server, Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shlwapi.h |
| Archivo DLL | Shlwapi.dll (versión 5.0 o posterior) |