IStream::Read

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method reads a specified number of bytes from the stream object into memory, starting at the current seek pointer.

Syntax

HRESULT Read( 
  void* pv, 
  ULONG cb, 
  ULONG* pcbRead 
);

Parameters

• pv
  [out] Pointer to the buffer into which the stream data is read. If an error occurs, this value is NULL.

• cb
  [in] Number of bytes of data to attempt to read from the stream object.

• pcbRead
  [out] Pointer to a ULONG variable that receives the actual number of bytes read from the stream object.

  You can set this pointer to NULL to indicate that you are not interested in this value. In this case, this method does not provide the actual number of bytes read.

Return Value

If the method succeeds, the return value is S_OK.

Remarks

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later