Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method reads data retrieved by the pluggable protocol handler.

Syntax 

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

Parameters

pv

[in, out] Address of the buffer where the information will be stored.

cb

[in] ULONG value that indicates the size of the buffer.

pcbRead

[out] Address of a ULONG value that indicates the amount of data stored in the buffer.

Return Value

Returns one of the values shown in the following table.

Value Description

INET_E_DATA_NOT_AVAILABLE

There is no more data available from the server, but more data was expected.

INET_E_DOWNLOAD_FAILURE

The read failed.

E_PENDING

The read operation is pending.

S_OK

The read was successful, but there is still additional data available.

S_FALSE

All of the data has been completely downloaded.

Remarks

Developers who are implementing an asynchronous pluggable protocol must be prepared to have their implementation of IInternetProtocol::Readcontinue to be called a few extra times after it has returned S_FALSE.

Requirements

Header urlmon.h, urlmon.idl
Library urlmon.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later