Método IWinHttpRequest::SetProxy
O método SetProxy define informações do servidor proxy.
Sintaxe
HRESULT SetProxy(
[in] HTTPREQUEST_PROXY_SETTING ProxySetting,
[in, optional] VARIANT ProxyServer,
[in, optional] VARIANT BypassList
);
Parâmetros
-
ProxySetting [in]
-
Os sinalizadores que controlam esse método. Pode ser um dos valores a seguir.
Valor Significado - HTTPREQUEST_PROXYSETTING_DEFAULT
Configuração de proxy padrão. Equivalente a HTTPREQUEST_PROXYSETTING_PRECONFIG. - HTTPREQUEST_PROXYSETTING_PRECONFIG
Indica que as configurações de proxy devem ser obtidas do registro. Isso pressupõe que Proxycfg.exe foi executado. Se Proxycfg.exe não tiver sido executado e HTTPREQUEST_PROXYSETTING_PRECONFIG for especificado, o comportamento será equivalente a HTTPREQUEST_PROXYSETTING_DIRECT. - HTTPREQUEST_PROXYSETTING_DIRECT
Indica que todos os servidores HTTP e HTTPS devem ser acessados diretamente. Use este comando se não houver nenhum servidor proxy. - HTTPREQUEST_PROXYSETTING_PROXY
Quando HTTPREQUEST_PROXYSETTING_PROXY é especificado, varProxyServer deve ser definido como uma cadeia de caracteres de servidor proxy e varBypassList deve ser definido como uma cadeia de caracteres de lista de bypass de domínio. Essa configuração de proxy se aplica somente à instância atual do objeto WinHttpRequest . -
ProxyServer [in, opcional]
-
Defina como uma cadeia de caracteres de servidor proxy quando ProxySetting for igual a HTTPREQUEST_PROXYSETTING_PROXY.
-
BypassList [in, opcional]
-
Defina como uma cadeia de caracteres de lista de bypass de domínio quando ProxySetting for igual a HTTPREQUEST_PROXYSETTING_PROXY.
Valor retornado
Caso contrário, o valor retornado será S_OK com êxito ou um valor de erro.
Comentários
Permite que o aplicativo de chamada especifique o uso de informações de proxy padrão (configuradas pela ferramenta de configuração de proxy) ou substitua Proxycfg.exe. Esse método deve ser chamado antes de chamar o método Send . Se esse método for chamado após o método Send , ele não terá efeito.
IWinHttpRequest passa esses parâmetros para Os Serviços HTTP do Microsoft Windows (WinHTTP).
Observação
Para Windows XP e Windows 2000, consulte a seção Requisitos de tempo de execução da página inicial do WinHTTP.
Exemplos
O exemplo a seguir mostra como definir as configurações de proxy para um servidor proxy específico, abrir uma conexão HTTP, enviar uma solicitação HTTP e ler o texto da resposta. Este exemplo deve ser executado em um prompt de comando. Essas configurações de proxy só funcionarão se você tiver um servidor proxy chamado "proxy_server" que usa a porta 80 e o computador puder ignorar o servidor proxy quando o nome do host terminar com ".microsoft.com".
#include <windows.h>
#include <stdio.h>
#include <objbase.h>
#include "httprequest.h"
#pragma comment(lib, "ole32.lib")
#pragma comment(lib, "oleaut32.lib")
// IID for IWinHttpRequest.
const IID IID_IWinHttpRequest =
{
0x06f29373,
0x5c5a,
0x4b54,
{0xb0, 0x25, 0x6e, 0xf1, 0xbf, 0x8a, 0xbf, 0x0e}
};
int main()
{
// Variable for return value
HRESULT hr;
// Initialize COM
hr = CoInitialize( NULL );
IWinHttpRequest * pIWinHttpRequest = NULL;
BSTR bstrResponse = NULL;
VARIANT varFalse;
VARIANT varEmpty;
VARIANT varProxy;
VARIANT varUrl;
CLSID clsid;
VariantInit(&varFalse);
V_VT(&varFalse) = VT_BOOL;
V_BOOL(&varFalse) = VARIANT_FALSE;
VariantInit(&varEmpty);
V_VT(&varEmpty) = VT_ERROR;
VariantInit(&varProxy);
VariantInit(&varUrl);
hr = CLSIDFromProgID(L"WinHttp.WinHttpRequest.5.1", &clsid);
if (SUCCEEDED(hr))
{
hr = CoCreateInstance(clsid, NULL,
CLSCTX_INPROC_SERVER,
IID_IWinHttpRequest,
(void **)&pIWinHttpRequest);
}
if (SUCCEEDED(hr))
{ // Specify proxy and URL.
varProxy.vt = VT_BSTR;
varProxy.bstrVal = SysAllocString(L"proxy_server:80");
varUrl.vt = VT_BSTR;
varUrl.bstrVal = SysAllocString(L"*.microsoft.com");
hr = pIWinHttpRequest->SetProxy(HTTPREQUEST_PROXYSETTING_PROXY,
varProxy, varUrl);
}
if (SUCCEEDED(hr))
{ // Open WinHttpRequest.
BSTR bstrMethod = SysAllocString(L"GET");
BSTR bstrUrl = SysAllocString(L"https://microsoft.com");
hr = pIWinHttpRequest->Open(bstrMethod, bstrUrl, varFalse);
SysFreeString(bstrMethod);
SysFreeString(bstrUrl);
}
if (SUCCEEDED(hr))
{ // Send Request.
hr = pIWinHttpRequest->Send(varEmpty);
}
if (SUCCEEDED(hr))
{ // Get Response text.
hr = pIWinHttpRequest->get_ResponseText(&bstrResponse);
}
if (SUCCEEDED(hr))
{ // Print the response to a console.
wprintf(L"%.256s",bstrResponse);
}
// Release memory.
if (pIWinHttpRequest)
pIWinHttpRequest->Release();
if (varProxy.bstrVal)
SysFreeString(varProxy.bstrVal);
if (varUrl.bstrVal)
SysFreeString(varUrl.bstrVal);
if (bstrResponse)
SysFreeString(bstrResponse);
CoUninitialize();
return 0;
}
O exemplo de script a seguir mostra como definir as configurações de proxy para um servidor proxy específico, abrir uma conexão HTTP, enviar uma solicitação HTTP e ler o texto da resposta. Essas configurações de proxy só funcionarão se você tiver um servidor proxy chamado "proxy_server" que usa a porta 80 e o computador puder ignorar o servidor proxy quando o nome do host terminar com ".microsoft.com".
// HttpRequest SetCredentials flags.
HTTPREQUEST_PROXYSETTING_DEFAULT = 0;
HTTPREQUEST_PROXYSETTING_PRECONFIG = 0;
HTTPREQUEST_PROXYSETTING_DIRECT = 1;
HTTPREQUEST_PROXYSETTING_PROXY = 2;
// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
// Use proxy_server for all requests outside of
// the microsoft.com domain.
WinHttpReq.SetProxy( HTTPREQUEST_PROXYSETTING_PROXY,
"proxy_server:80",
"*.microsoft.com");
// Initialize an HTTP request.
WinHttpReq.Open("GET", "https://www.microsoft.com", false);
// Send the HTTP request.
WinHttpReq.Send();
// Display the response text.
WScript.Echo( WinHttpReq.ResponseText);
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho] |
| Redistribuível |
WinHTTP 5.0 e Internet Explorer 5.01 ou posterior no Windows XP e Windows 2000. |
| IDL |
|
| Biblioteca |
|
| DLL |
|