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 function reads data from a handle opened by the InternetOpenUrl, FtpOpenFile, or HttpOpenRequestfunction.

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. InternetReadFilesets 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 InternetGetLastResponseInfowhen necessary.

Remarks

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

The InternetReadFilefunction 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