WinHTTP教程

最近有些忙,也没更新BLOG,这几天在捣鼓一个小玩意要用到WinHTTP API,发现资料很少,而且大都是些MFC封装的例子,看得我是一个头几个大。就把自己关于WinHTTP的学习总结了一下,仅供参考,各人理解可能有区别。另外非常感谢前人在网络上提供的相关参考。

BTW:Google Chrome就是基于WinHTTP写的,如果想深入学习,可以阅读分析Chrome Code.
从此处获取Chrome的源代码等相关信息
SVN: http://src.chromium.org/svn/trunk/src/chrome/
VIEW: http://src.chromium.org/viewvc/

WinHTTP APIs是一组用来进行HTTP操作的函数,相比WinINet更加安全和健壮一些。

WinHTTP API List:

WinHttpAddRequestHeaders
WinHttpCheckPlatform
WinHttpCloseHandle
WinHttpConnect
WinHttpCrackUrl
WinHttpCreateUrl
WinHttpDetectAutoProxyConfigUrl
WinHttpGetDefaultProxyConfiguration
WinHttpGetIEProxyConfigForCurrentUser
WinHttpGetProxyForUrl
WinHttpOpen
WinHttpOpenRequest
WinHttpQueryAuthSchemes
WinHttpQueryDataAvailable
WinHttpQueryHeaders
WinHttpQueryOption
WinHttpReadData
WinHttpReceiveResponse
WinHttpSendRequest
WinHttpSetCredentials
WinHttpSetDefaultProxyConfiguration
WinHttpSetOption
WinHttpSetStatusCallback
WinHttpSetTimeouts
WinHttpTimeFromSystemTime
WinHttpTimeToSystemTime
WinHttpWriteData


WinHTTP API逻辑上分成三个独立的对象进行建模:会话对象、连接对象、请求对象。大致为:

初始化WinHTTP(获得会话对象,)-->创建连接(连接1,连接2,...N)-->发送请求(请求1,请求2,....N)

会话对象、连接对象、请求对象都由HINTERNET句柄表示,句柄的使用传递过程大致为:

WinHttpOpen-->return Session handle
                        |
WinHttpConnect-->return Connection handle
                        |
WinHttpOpenRequest-->return Request handle

各对象句柄可以使用WinHttpCloseHandle进行关闭。为了进一步加深了解WinHTTP APIs的调用过程和关系,我们来看下面的图:

                                                           (图来自MSDN)


会话对象
会话对象使用WinHttpOpen函数来进行创建。函数原形如下:

HINTERNET WinHttpOpen(
          __in LPCWSTR   pwszUserAgent,
          __in DWORD   dwAccessType,
          __in LPCWSTR   pwszProxyName,
          __in LPCWSTR   pwszProxyBypass
          __in DWORD   dwFlags
);

第一个参数指向一个应用程序自身名称及版本的字符串,使用在HTTP协议的User Agent中。如:Mozilla/4.0
第二个参数是WinHttp的访问类型要求。可能为下列值
WINHTTP_ACCESS_TYPE_NO_PROXY             //不使用默认代理服务器
WINHTTP_ACCESS_TYPE_DEFAULT_PROXY   //使用默认的代理服务器(储存在注册表中的WINHTTP代理设置,注意:与IE的代理设置不同,为独立的)
WINHTTP_ACCESS_TYPE_NAMED_PROXY //使用指定的代理服务器设置
第三个参数指向一个代理服务器名称的字符串,如果前一个参数dwAccessType未设置为WINHTTP_ACCESS_TYPE_NAMED,这个参数就必须为WINHTTP_NO_PROXY_NMAE。
第四个参数指向一个HTTP服务器列表,其中的服务器不能通过前一个参数指定的代理服务器进行路由(这与IE代理服务器设置中的例外情况设置类似)
第五个参数定义了一个标记,当前只定义了一个标记
WINHTTP_FLAG_ASYNC //指示WinHTTP API将异步执行。

连接对象
连接对象使用WinHttpConnect函数来进行创建(注意前面提到的一个会话对象可以创建多个连接对象)。函数原形如下:

HINTERNET WinHttpConnect(
          __in HINTERNET   hSession,
          __in LPCWSTR   pswzServerName,
          __in INTERNET_PORT   nServerPort
          __in reserved DWORD   dwReserved
);

第一个参数指定连接的所属会话句柄。
第二个参数指定连接的服务器名称或IP地址
第三个参数指定服务器的端口号,这个参数还可以指定为下列值
INTERNET_DEFAULT_HTTP_PORT //使用默认HTTP Service端口号80
INTERNET_DEFAULT_HTTPS_PORT //使用默认HTTPS安全连接端口号443
INTERNET_DEFAULT_PORT //常规HTTP请求使用80,HTTPS请求使用443(这是个便利的参数值)
第四个参数是保留的,必须为0

请求对象
请求对象使用WinHttpOpenRequest函数来进行创建(注意前面提到的一个连接对象可以创建多个请求对象)。从请求对象开始,就进入原本目的HTTP操作了。函数原形如下:

HINTERNET WinHttpOpenRequest(
          __in HINTERNET   hConnect,
          __in LPCWSTR   pwszVerb,
          __in LPCWSTR   pwszObjectName,
          __in LPCWSTR   pwszVersion,
          __in LPCWSTR   pwszReferrer,
          __in LPCWSTR   *ppwszAcceptTypes,
          __in DWORD   dwFlags
)

第一个参数指定请求所属的连接句柄
第二个参数指定HTTP协议动作(如:GET、POST和HEAD),如果此参数为NULL,函数会默认使用GET。
第三个参数指定正在请求的资源名称和相对路径
第四个参数指定使用的HTTP协议版本,如果此参数为NULL,函数会默认使用HTTP/1.1
第五个参数指定引用的URL,如果没有,可以设置为WINHTTP_NO_REFERER
第六个参数指定客户端(本应用程序)将接受的媒体类型(如:image/gif、text/*、*/*),一般可以指定为WIN_HTTP_DEFAULT_ACCEPT_TYPES。
第七个参数指定请求行为标记,如可以指定为WINHTTP_FLAG_SECURE标记发出HTTPS请求,一般可以为0。其他可指定值请参考MSDN,我就不罗列了。


至此介绍了三个WinHTTP API,经过这个过程就基本建立了一个HTTP网络连接。由此我们已经对WInHTTP有了基本概念性的认识。WinHTTP APIs(2)中将再介绍利用WinHTTP API进行更为复杂的操作和实际的应用例子

你可能感兴趣的:(技术文摘)