WinInet中的几个网络函数

0

InternetGetConnectedState

BOOL InternetGetConnectedState(OUT LPDWORD lpdwFlags, IN DWORD dwReserved );

判断当前是否有internet连接
有则返回 true，无则 false

若有连接，则lpdwFlags 中会存放着连接方式

 

1

InternetOpen初始化WININET.DLL。它在其他的Win32网络函数之前被调用。 

HINTERNET hNet = ::InternetOpen( 
"MSDN SurfBear",  // 1 LPCTSTR lpszCallerName 
PRE_CONFIG_INTERNET_ACCESS,  // 2 DWORD dwAccessType 
"",  // 3 LPCTSTR lpszProxyName 
INTERNET_INVALID_PORT_NUMBER,  // 4 INTERNET_PORT nProxyPort 
0  // 5 DWORD dwFlags 
) ; 
InternetOpen返回一个类型为HINTERNET的句柄。其他的Win32网络函数把这个句柄当作一个参数。

InternetOpen 的第一个参数lpszCallerName指定正在使用网络函数的应用程序。当HTTP协议使用时，这个名字将变成用户代理。 
第二个参数dwAccessType指定访问类型。

NProxyPort参数用在CERN_PROXY_INTERNET_ACCESS中用来指定使用的端口数。使用INTERNET_INVALID_PORT_NUMBER相当于提供却省的端口数。
最后一个参数dwFlags，设置额外的选择。

 

 

当结束使用Wein32网络函数时，应该调用 InternetCloseHandle释放InternetOpen分配的资源。

 

2

InternetOpenUrl函数连接到一个网络服务器上并且最被从服务器上读取数据。InternetOpenUrl能对FTP，Gopher或HTTP协议起作用。

HINTERNET hUrlFile = ::InternetOpenUrl( 
hNet,  // 1 HINTERNET hInternetSession 
"http://www.microsoft.com",  // 2 LPCTSTR lpszUrl 
NULL,  // 3 LPCTSTR lpszHeaders 
0,  // 4 DWORD dwHeadersLength 
INTERNET_FLAG_RELOAD,  // 5 DWORD dwFlags 
0  // 6 DWORD dwContext 
) ; 
InternetOpenUrl返回一个HINTERNET，它被传递给在这个URL（统一资源定位）上操作的函数。
InternetOpenUrl的第一个参数hInternetSession是从InternetOpen返回的句柄。第二个参数lpszUrl是需要的资源的URL。下面两个参数lpszHeaders和HeaderLength用来向服务器传送额外的信息。使用这些参数要求具有正在使用的特定协议的知识。 

DwFlag是一个可以用几种方式修改InternetOpenUrl行为的标志，InternetOpenUrl的行为包括关闭、隐藏，使原始数据可用和用存在的连接取代开辟一个新的连接。 

最后一个参数dwContext是一个 DWORD上下文值。如果有一个值已经被指定，它将被送到状态回调函数。如果这个值是0，信息将不会被送到状态回调函数。

 

 

3

InternetReadFile函数用来读取文件

 

BOOL bRead = ::InternetReadFile( 
hUrlFile,  // 1 HINTERNET hFile 
buffer,  // 2 LPVOID lpBuffer 
sizeof(buffer),  // 3 DWORD dwNumberOfBytesToRead 
&dwBytesRead  // 4 LPDWORD lpdwNumberOfBytesRead 
); 

InternetReadFile接收InternetOpenUrl返回的句柄。它也对其他Win32网络函数，例如FtpOpenFile,FopherOpenFile和HttpOpenRequest返回的句柄有影响。 

剩下的InternetReadFile的三个参数也非常的明白直接。Inbuffer是指向保留数据的缓冲区的一个无返回值指针，dwNumberOfByteToRead以字节为单位指定缓冲区的尺寸。最后一个参数，lpdwNumberOfBytesRead是一个指向包含读入缓冲区字节数的变量的指针。如果返回值是TRUE，而且lpdwNumberOfBytesRead指向0，则文件已经读到了文件的末尾。

 

 

4
InternetConnet函数连接到一个HTTP，FTP或Gopher服务器：
HINTERNET hConnect = ::InternetConnect(
          hSession,                    //1 HINTERNET hInternetSession
          "www.microsoft.com",          //2 LPCTSTR lpszServerName
          INTERNET_INVALID_PORT_NUMBER, //3 INTERNET_PORT nServerPort
          "",                            //4 LPCTSTR lpszUsername
          "",                            //5 LPCTSTR lpszPassword
          INTERNET_SERVICE_HTTP,         //6 DWORD dwService
          0,                             //7 DWORD dwFlags
          O                              //8 DWORD dwContext
) ;
    第六个参数dwService决定服务类型（HTTP，FTP或Gopher）。第二个参数（设置成 www.microsoft.com）提供了服务器的地址。第一个参数hInternetSession是从InternetOpen返回的句柄。第四个、第五个参数提供一个用户姓名和密码 。这七个参数没有控制任何标志影响HTTP操作。最后一个参数为状态回调函数提供前后关系的信息。

 

5
HttpOpenRequest创建一个请求句柄并且把参数存储在句柄中。HINTERNET hHttpFile = ::HttpOpenRequest(
          hConnect,               // 1 HINTERNET hHttpSession
          "GET",                  // 2 LPCTSTR lpszVerb
          "/MSDN/MSDNINFO/",      // 3 LPCTSTR lpszObjectName
          HTTP_VERSION,           // 4 LPCTSTR lpszVersion
          NULL,                     // 5 LPCTSTR lpszReferer
          0,                     // 6 LPCTSTR FAR * lplpszAcceptTypes
          INTERNET_FLAG_DONT_CACHE,   // 7 DWORD dwFlags
          0                       // 8 DWORD dwContext
) ;
  HttpOpenRequest的第一个参数是由InternetConnet返回的HINTERNET。HttpOpenRequest的第七和第八个参数执行与InternetConnect中有相同名字的参数一样的功能。
    第二个参数（“GET”）指定想要得到由第三个参数（“/MSDN/MSDNINFO/”）命名的对象。HTTP版已经传递第四个参数；现在，它肯定是HTTP VERSION。因为“GET”是最流行的动词类型，HttpOpenRequest将为这个参数接收一个空指针。
    第五个参数lpszReferer是一个网点的地址。这个值可以为空。第六个参数执行一个程序接收的文件类型列表。把空值传递给HttpOpenRequest即通知了服务器只有文本文件可以被接收。

　
6
HttpSendRequest把请求参数送到HTTP服务器。
除了传送请求外，HttpSendRequest允许传送额外的HTTP标题给服务器。关于HTTP标题的信息可以在 http://www.w3.org/ 上的最新的说明上找到。
BOOL bSendRequest = ::HttpSendRequest(
     hHttpFile,  // 1 HINTERNET hHttpRequest
     NULL,       // 2 LPCTSTR lpszHeaders
     0,          // 3 DWORD dwHeadersLength
     0,          // 4 LPVOID lpOptional
     0           // 5 DWORD dwOptionalLength
);

 

 

7
为了得到关于文件的信息，在调用HttpSendRequest后使用 HttpQueryInfo函数：

BOOL bQuery = ::HttpQueryInfo(
     hHttpFile,                  // 1 HINTERNET hHttpRequest
     HTTP_QUERY_CONTENT_LENGTH,  // 2 DWORD dwInfoLevel
     bufQuery,                   // 3 LPVOID lpvBuffer
     &dwLengthBufQuery           // 4 LPDWORD lpdwBufferLength
) ;
查询的结构是字符串或lpvBuffer中的字符串列表。HTTP_QUERY_CONTENT_LENGTH查询得到文件的长度。可以使用HttpQueryInfo查询大范围的信息。

 

 

 

此外，wininet中还有其他协议的函数,比如一系列FTP协议的函数

FtpCreateDirectory

FtpDeleteFile

FtpFindFirstFile

FtpGetCurrentDirectory

FtpGetFile

FtpOpenFile

FtpPutFile

FtpRemoveDirectory

FtpRenameFile

FtpSetCurrentDirectory