什么是WinHTTP?

WinHTTP的全称是Microsoft Windows HTTP Services, 它提供给开发者一个HTTP客户端应用程序接口(API), 通过这种API借助HTTP协议给其他的HTTP服务器发送请求.

WinHTTP支持桌面应用程序, Windows系统服务, 和Windows服务器端应用程序.

对于基于Microsoft .NET Framework的应用程序, 不推荐使用WinHTTP服务, 因为.NET Framework应用程序应该使用在System.Net命名空间下的网络基础设施类型.

WinHTTP提供了两种编程方式, 一种是C\C++的API, 另一种是COM组件.

WinHTTP与WinINet的区别

================

WinHTTP被设计为主要应用在服务器端应用程序的场景下, 让服务器端应用程序访问HTTP服务器.

WinINet是一种更老的技术, 它被设计为一个HTTP客户端平台, 用于交互式桌面应用程序, 比如说IE, Office等.

服务器端应用程序要求HTTP客户端服务使用WinHTTP而不是WinINet.

WinHTTP和WinINet在微软是由不同的团队来提供支持的.

WinHTTP与Proxy

================

如果HTTP Proxy需要认证(authentication), 那么HTTP Application会收到407(proxy requires authentication). 除了这个状态码, 代理服务器还会发送一个或更多的authenticate headers: "Proxy-Authenticate". 这些信息足够我们在network monitor trace中鉴定HTTP无法访问是否是由于proxy需要认证引起的了.

WinHTTP的proxy配置是存储在注册表键

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\Connections\WinHttpSettings

当中的, 修改和查看需要使用一个命令行工具proxycfg.

实际上, 通过代理来使用WinHTTP访问HTTP和HTTPS的主机有两种方式.

在应用程序中指定代理配置. 举例如下:

hSession = WinHttpOpen( L"WinHTTP Example/1.0",  
                    WINHTTP_ACCESS_TYPE_NAMED_PROXY,
                    L"proxy_name", 
                    L"<local>", 
                    0);

或者

WINHTTP_PROXY_INFO proxyInfo;
proxyInfo.dwAccessType = WINHTTP_ACCESS_TYPE_NAMED_PROXY;
proxyInfo.lpszProxy = L"proxy_name";
proxyInfo.lpszProxyBypass = L"<local>";
    
// Set the proxy information for this session.
WinHttpSetOption( hSession, 
                  WINHTTP_OPTION_PROXY, 
                  &proxyInfo, 
                  sizeof(proxyInfo));

在应用程序外配置默认的代理配置, 这里需要使用位于%windir%\system32目录下的命令行工具proxycfg.exe.

proxycfg -p "http=http_proxy https=https_proxy" "<local>;*.microsoft.com"

上面的命令指定使用名为http_proxy的代理服务器访问http主机, 使用名为https_proxy的代理服务器访问https主机.

该命令还指定了访问local intranet的站点还有任何匹配"*.microsoft.com"的站点的时候, 不使用代理.

WinHTTP和System.Net中的类在配置代理时的区别

===============

上面讲到过, 如果应用程序是基于.net framework的, 那么并不推荐使用WinHTTP来作为http客户端, 推荐使用的是System.Net中的类型. WinHTTP可以用上面的代码或proxycfg来配置, System.Net下的类型靠啥来配置呢?

答案是靠config文件. .Net Framework使用标准的XML文件作为配置文件, 存放配置信息. 可执行文件有.config文件, asp.net站点有web.config文件.

config文件中的<system.Net>元素中包含有指定.net framework如何连接网络的配置信息. 其中的<defaultProxy>元素包含的就是HTTP代理服务器的配置. 这个元素有三个子元素:

bypasslist- 提供了一个正则表达式的集合, 用于描述不适用代理的站点.
module- 为应用程序添加一个新的proxy module
proxy- 指定proxy服务器

举例

<configuration>
  <system.net>
    <defaultProxy>
      <bypasslist>
        <add address="[a-z]+\.contoso\.com$" />
        <add address="192\.168\.\d{1,3}\.\d{1,3}" />
      </bypasslist>
    </defaultProxy>
  </system.net>
</configuration>