WinHTTP AutoProxy 函数
WinHTTP 使用 WinHttpGetProxyForUrl 函数以及两个支持的实用工具函数 WinHttpDetectAutoProxyConfigUrl 和 WinHttpGetIEProxyConfigForCurrentUser 实现 WPAD 协议。
AutoProxy 支持未完全集成到 WinHTTP 中的 HTTP 堆栈中。 在发送请求之前，应用程序必须调用 WinHttpGetProxyForUrl 以获取代理服务器的名称，然后使用WINHTTP_OPTION_PROXY调用 WinHttpSetOption 来设置 WinHttpOpenRequest 创建的 WinHTTP 请求句柄上的代理配置。
WinHttpGetProxyForUrl 函数可执行上述概述中所述的 WPAD 协议的所有三个步骤： (1) 发现 PAC URL， (2) 下载 PAC 脚本文件， (3) 执行脚本代码，并在WINHTTP_PROXY_INFO结构中返回代理配置。 （可选）如果应用程序事先知道 PAC URL，则可以将其指定给 WinHttpGetProxyForUrl。
以下示例代码使用 autoproxy。 它通过首先创建 WinHTTP 会话连接和请求句柄来设置 HTTP GET 请求。 WinHttpOpen 调用指定初始代理配置的WINHTTP_ACCESS_TYPE_NO_PROXY，以指示默认情况下将请求直接发送到目标服务器。 然后，它使用 autoproxy 直接在请求句柄上设置代理配置。
HINTERNET hHttpSession = NULL;
HINTERNET hConnect = NULL;
HINTERNET hRequest = NULL;
WINHTTP_AUTOPROXY_OPTIONS AutoProxyOptions;
WINHTTP_PROXY_INFO ProxyInfo;
DWORD cbProxyInfoSize = sizeof(ProxyInfo);
ZeroMemory( &AutoProxyOptions, sizeof(AutoProxyOptions) );
ZeroMemory( &ProxyInfo, sizeof(ProxyInfo) );
//
// Create the WinHTTP session.
//
hHttpSession = WinHttpOpen( L"WinHTTP AutoProxy Sample/1.0",
WINHTTP_ACCESS_TYPE_NO_PROXY,
WINHTTP_NO_PROXY_NAME,
WINHTTP_NO_PROXY_BYPASS,
0 );
// Exit if WinHttpOpen failed.
if( !hHttpSession )
goto Exit;
//
// Create the WinHTTP connect handle.
//
hConnect = WinHttpConnect( hHttpSession,
L"www.microsoft.com",
INTERNET_DEFAULT_HTTP_PORT,
0 );
// Exit if WinHttpConnect failed.
if( !hConnect )
goto Exit;
//
// Create the HTTP request handle.
//
hRequest = WinHttpOpenRequest( hConnect,
L"GET",
L"ms.htm",
L"HTTP/1.1",
WINHTTP_NO_REFERER,
WINHTTP_DEFAULT_ACCEPT_TYPES,
0 );
// Exit if WinHttpOpenRequest failed.
if( !hRequest )
goto Exit;
//
// Set up the autoproxy call.
//
// Use auto-detection because the Proxy
// Auto-Config URL is not known.
AutoProxyOptions.dwFlags = WINHTTP_AUTOPROXY_AUTO_DETECT;
// Use DHCP and DNS-based auto-detection.
AutoProxyOptions.dwAutoDetectFlags =
WINHTTP_AUTO_DETECT_TYPE_DHCP |
WINHTTP_AUTO_DETECT_TYPE_DNS_A;
// If obtaining the PAC script requires NTLM/Negotiate
// authentication, then automatically supply the client
// domain credentials.
AutoProxyOptions.fAutoLogonIfChallenged = TRUE;
//
// Call WinHttpGetProxyForUrl with our target URL. If
// auto-proxy succeeds, then set the proxy info on the
// request handle. If auto-proxy fails, ignore the error
// and attempt to send the HTTP request directly to the
// target server (using the default WINHTTP_ACCESS_TYPE_NO_PROXY
// configuration, which the requesthandle will inherit
// from the session).
//
if( WinHttpGetProxyForUrl( hHttpSession,
L"https://www.microsoft.com/ms.htm",
&AutoProxyOptions,
&ProxyInfo))
{
// A proxy configuration was found, set it on the
// request handle.
if( !WinHttpSetOption( hRequest,
WINHTTP_OPTION_PROXY,
&ProxyInfo,
cbProxyInfoSize ) )
{
// Exit if setting the proxy info failed.
goto Exit;
}
}
//
// Send the request.
//
if( !WinHttpSendRequest( hRequest,
WINHTTP_NO_ADDITIONAL_HEADERS,
0,
WINHTTP_NO_REQUEST_DATA,
0,
0,
NULL ) )
{
// Exit if WinHttpSendRequest failed.
goto Exit;
}
//
// Wait for the response.
//
if( !WinHttpReceiveResponse( hRequest, NULL ) )
goto Exit;
//
// A response has been received, then process it.
// (omitted)
//
Exit:
//
// Clean up the WINHTTP_PROXY_INFO structure.
//
if( ProxyInfo.lpszProxy != NULL )
GlobalFree(ProxyInfo.lpszProxy);
if( ProxyInfo.lpszProxyBypass != NULL )
GlobalFree( ProxyInfo.lpszProxyBypass );
//
// Close the WinHTTP handles.
//
if( hRequest != NULL )
WinHttpCloseHandle( hRequest );
if( hConnect != NULL )
WinHttpCloseHandle( hConnect );
if( hHttpSession != NULL )
WinHttpCloseHandle( hHttpSession );
在提供的示例代码中，对 WinHttpGetProxyForUrl 的调用指示函数通过在 WINHTTP_AUTOPROXY_OPTIONS 结构中指定 WINHTTP_AUTOPROXY_AUTO_DETECT 标志来自动发现 代理自动 配置文件。 使用 WINHTTP_AUTOPROXY_AUTO_DETECT 标志需要代码指定一个或两个自动检测标志 (WINHTTP_AUTO_DETECT_TYPE_DHCP， WINHTTP_AUTO_DETECT_TYPE_DNS_A) 。 示例代码使用 WinHttpGetProxyForUrl 的自动检测功能，因为事先不知道 PAC URL。 如果在此方案中无法在网络上找到 PAC URL， 则 WinHttpGetProxyForUrl 将失败， (GetLastError 返回 ERROR_WINHTTP_AUTODETECTION_FAILED) 。
如果 PAC URL 是“提前已知”
如果应用程序知道 PAC URL，则可以在WINHTTP_AUTOPROXY_OPTIONS结构中指定它，并将 WinHttpGetProxyForUrl 配置为跳过自动检测阶段。
例如，如果 PAC 文件位于本地网络上的 URL“https://InternalSite/proxy-config.pac"，则对 WinHttpGetProxyForUrl 的调用如下所示。
//
// Set up the autoproxy call.
//
// The proxy auto-config URL is known. Auto-detection
// is not required.
AutoProxyOptions.dwFlags = WINHTTP_AUTOPROXY_CONFIG_URL;
// Set the proxy auto-config URL.
AutoProxyOptions. lpszAutoConfigUrl = L"https://InternalSite/proxy-config.pac";
// If obtaining the PAC script requires NTLM/Negotiate
// authentication, then automatically supply the client
// domain credentials.
AutoProxyOptions.fAutoLogonIfChallenged = TRUE;
//
// Call WinHttpGetProxyForUrl with our target URL. If auto-proxy
// succeeds, then set the proxy info on the request handle.
// If auto-proxy fails, ignore the error and attempt to send the
// HTTP request directly to the target server (using the default
// WINHTTP_ACCESS_TYPE_NO_PROXY configuration, which the request
// handle will inherit from the session).
//
if( WinHttpGetProxyForUrl( hHttpSession,
L"https://www.microsoft.com/ms.htm",
&AutoProxyOptions,
&ProxyInfo ) )
{
//...
如果 WINHTTP_AUTOPROXY_OPTIONS 结构同时指定 (WINHTTP_AUTOPROXY_AUTO_DETECT 和 WINHTTP_AUTOPROXY_CONFIG_URL 标志，并指定自动解除功能标志和) 自动配置 URL， 则 WinHttpGetProxyForUrl 首先尝试自动检测，如果自动检测无法找到 PAC URL，则“回退”到应用程序提供的自动配置 URL。
WinHttpDetectAutoProxyConfigUrl 函数
WinHttpDetectAutoProxyConfigUrl 函数实现 WPAD 协议的子集：它尝试自动检测代理自动配置文件的 URL，而无需下载或执行 PAC 文件。 在 Web 客户端应用程序必须处理 PAC 文件本身的下载和执行的特殊情况下，此函数非常有用。
WinHttpGetIEProxyConfigForCurrentUser 函数
WinHttpGetIEProxyConfigForCurrentUser 函数返回当前活动网络连接的当前用户 Internet Explorer 代理设置，而不调用“WinInet.dll”。 仅当在交互式用户帐户标识下运行的进程内调用时，此函数才有用，因为否则可能没有 Internet Explorer 代理配置可用。 例如，从 IIS 服务进程中运行的 ISAPI DLL 调用此函数将没有用。 有关详细信息，以及基于 WinHTTP 的应用程序将使用 WinHttpGetIEProxyConfigForCurrentUser 的方案，请参阅 没有自动配置文件的发现。
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈