IInternetProtocol::Read


		Contents Index Topic Contents
	Previous Topic: IInternetProtocol::LockRequest Next Topic: IInternetProtocol::Seek

IInternetProtocol::Read
HRESULT Read(
    [out] LPVOID pv,
    [in] ULONG cb,
    [out] ULONG *pcbRead
);
Reads data retrieved by the pluggable protocol handler.
Returns one of the following values:

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.

pv
Address of the buffer where the information will be stored.
cb
ULONG value that indicates the size of the buffer.
pcbRead
Address of a ULONG value that indicates the amount of data stored in the buffer.

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

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.

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.