InternetReadFile() 函数讲解

InternetReadFile Function

从一个由InternetOpenUrl, FtpOpenFile, 或 HttpOpenRequest 函数打开的句柄中读取数据。

Syntax

C++

<code><span style="font-family: 新宋体; ">BOOL InternetReadFile(
  __in   HINTERNET <em>hFile</em>,
  __out  LPVOID <em>lpBuffer</em>,
  __in   DWORD <em>dwNumberOfBytesToRead</em>,
  __out  LPDWORD <em>lpdwNumberOfBytesRead</em>
);</span></code>

Parameters

hFile [in]

由InternetOpenUrl, FtpOpenFile, 或 HttpOpenRequest 函数返回的句柄.

lpBuffer [out]

缓冲器指针

dwNumberOfBytesToRead [in]

欲读数据的字节量。

lpdwNumberOfBytesRead [out]

接收读取字节量的变量。该函数在做任何工作或错误检查之前都设置该值为零

返回值

成功：返回TRUE，失败，返回FALSE

备注

该函数的操作非常类似于ReadFile函数。典型情况下，该函数从一个作为字节顺序流的HINTERNET句柄中返回数据。每次函数读取的数据量都由dwNumberOfBytesToRead参数指定，并且数据返回到lp
Buffer参数里。一个正常读取将持续到文件结束时为止。为了确保所有数据被接收，应用程序必须继续使用该函数直到函数返回TRUE且lpdwNumberOfBytesRead参数等于零值。此举在请求的数据被写入缓存中尤为重要，因为如不这样的话，缓存将不会正常的更新且下载的文件也将不会被允许写入到缓存中。注意：除了原始请求的命令设置为INTERNET_FLAG_NO_CACHE_WRITE标识的情况外，缓存操作都会自动进行。

当应用程序使用InternetOpenUrl函数获得一个句柄时，WinINet试图将所有的数据都变得如同文件下载一样。

WinINet试图每次向lpBuffer缓冲中写入一行HTML。如果应用程序的缓冲区太小以至于不能承载一行的HTML数据，错误代码ERROR_INSUFFICIENT_BUFFER 将发送给应用程序，通知它需要更大的缓冲区。同样，转换的行数也不一定和缓冲区的大小匹配，所以该函数可以返回比lpBuffer缓冲少的数据。接下来的读取工作将返回所有的HTML数据。应用程序必须再次检查搜有数据是否都被接收。

要求

Minimum supported client	Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Version	Internet Explorer 3.0 or later
Header	Wininet.h
Library	Wininet.lib
DLL	Wininet.dll