InternetReadFileExA function

Reads data from a handle opened by the InternetOpenUrl or HttpOpenRequest function.

Syntax

BOOLAPI InternetReadFileExA(
  HINTERNET           hFile,
  LPINTERNET_BUFFERSA lpBuffersOut,
  DWORD               dwFlags,
  DWORD_PTR           dwContext
);

Parameters

hFile

Handle returned by the InternetOpenUrl or HttpOpenRequest function.

lpBuffersOut

Pointer to an INTERNET_BUFFERS structure that receives the data downloaded.

dwFlags

This parameter can be one of the following values.

Value Meaning
IRF_ASYNC
Identical to WININET_API_FLAG_ASYNC.
IRF_SYNC
Identical to WININET_API_FLAG_SYNC.
IRF_USE_CONTEXT
Identical to WININET_API_FLAG_USE_CONTEXT.
IRF_NO_WAIT
Do not wait for data. If there is data available, the function returns either the amount of data requested or the amount of data available (whichever is smaller).

dwContext

A caller supplied context value used for asynchronous operations.

Return Value

Returns TRUE if successful, or FALSE otherwise. To get extended error information, call GetLastError. An application can also use InternetGetLastResponseInfo when necessary.

Remarks

Note  WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).
 

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wininet.h
Library Wininet.lib
DLL Wininet.dll

See Also

Common Functions

WinINet Functions