IInternetProtocol::Read (Windows Embedded CE 6.0)

  • Article

1/6/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::Read continue 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

See Also

Reference

IInternetProtocol