InternetReadFile

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function reads data from a handle opened by the InternetOpenUrl, FtpOpenFile, or HttpOpenRequest function.

Syntax

BOOL WINAPI InternetReadFile(
  HINTERNET hFile, 
  LPVOID lpBuffer, 
  DWORD dwNumberOfBytesToRead, 
  LPDWORD lpdwNumberOfBytesRead
);

Parameters

  • hFile
    [in ] Valid handle returned from a previous call to InternetOpenUrl, FtpOpenFile, or HttpOpenRequest.
  • lpBuffer
    [in] Long pointer to a buffer that receives the data read.
  • dwNumberOfBytesToRead
    [in] Specifies the number of bytes to read.
  • lpdwNumberOfBytesRead
    [out] Long pointer to a variable that receives the number of bytes read. InternetReadFile sets this value to zero before doing any work or error checking.

Return Value

TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError. An application can also use InternetGetLastResponseInfo when necessary.

Remarks

Windows Embedded CE supports valid Internet handles returned by HttpOpenRequest, FtpOpenFile, and InternetOpenUrl.

The InternetReadFile function can be completed in either synchronous or asynchronous mode.

Requirements

Header wininet.h
Library wininet.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

FtpFindFirstFile
FtpOpenFile
HttpEndRequest
HttpOpenRequest
HttpSendRequestEx
InternetCloseHandle
InternetGetLastResponseInfo
InternetOpenUrl
WinInet Functions

Concepts

About HINTERNET Handles