Click to return to the Networking, Protocols     
InternetReadFile Function     InternetSetFilePointer Fu...     General Win32 Internet Fu...    
Web Workshop  |  Networking, Protocols & Data Formats

InternetReadFileEx Function


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

Syntax

BOOL InternetReadFileEx(
    IN HINTERNET hFile,
    OUT LPINTERNET_BUFFERS lpBuffersOut,
    IN DWORD dwFlags,
    IN DWORD dwContext
);

The actual syntax of this function varies between its ANSI and Unicode implementations. For more information, see Win32 Internet Functions Syntax.

Parameters

hFile
HINTERNET handle returned by the InternetOpenUrl, FtpOpenFile, GopherOpenFile, or HttpOpenRequest function.
lpBuffersOut
Address of an INTERNET_BUFFERS structure that contains the data downloaded.
dwFlags
Unsigned long integer variable that contains the flags controlling the download. This can be one of the following values:
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
Unsigned long integer variable that contains the 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.

Function Information

Windows NT Use version 4.0. Implemented as ANSI and Unicode functions.
Windows Use Windows 95 and later. Implemented as ANSI and Unicode functions.
Header Wininet.h
Import library Wininet.lib
Minimum availability Internet Explorer 4.0 (ANSI only), 5 (ANSI and Unicode)

Windows CE

Windows CE Use version 2.12 and later. Implemented as ANSI and Unicode functions.
Minimum availability Internet Explorer 4.0

See Also

Microsoft Win32 Internet Functions Overview, Common Functions, Microsoft Win32 Internet Functions Reference, General Win32 Internet Functions



Back to topBack to top

Did you find this topic useful? Suggestions for other topics? Write us!

© 1999 Microsoft Corporation. All rights reserved. Terms of use.