Compartilhar via

estrutura WINHTTP_AUTOPROXY_OPTIONS (winhttp.h)

  • Artigo

A estrutura WINHTTP_AUTOPROXY_OPTIONS é usada para indicar para a função WinHttpGetProxyForURL se deseja especificar a URL do arquivo PAC (Configuração Automática de Proxy) ou localizar automaticamente a URL com consultas DHCP ou DNS na rede.

Sintaxe

typedef struct _WINHTTP_AUTOPROXY_OPTIONS {
  DWORD   dwFlags;
  DWORD   dwAutoDetectFlags;
  LPCWSTR lpszAutoConfigUrl;
  LPVOID  lpvReserved;
  DWORD   dwReserved;
  BOOL    fAutoLogonIfChallenged;
} WINHTTP_AUTOPROXY_OPTIONS, *PWINHTTP_AUTOPROXY_OPTIONS;

Membros

dwFlags

Os mecanismos devem ser usados para obter o arquivo PAC.

Valor Significado
WINHTTP_AUTOPROXY_ALLOW_AUTOCONFIG
 Habilita a detecção de proxy por meio da URL de configuração automática.
 
Nota O suporte para esse sinalizador foi introduzido no Windows 10, versão 1703 (10.0; Build 15063).
 
WINHTTP_AUTOPROXY_ALLOW_CM
 Habilita a detecção de proxy por meio do gerenciador de conexões.
 
Nota O suporte para esse sinalizador foi introduzido no Windows 10, versão 1703 (10.0; Build 15063).
 
WINHTTP_AUTOPROXY_ALLOW_STATIC
 Habilita a detecção de proxy por meio da configuração estática.
 
Nota O suporte para esse sinalizador foi introduzido no Windows 10, versão 1703 (10.0; Build 15063).
 
WINHTTP_AUTOPROXY_AUTO_DETECT
 Tente descobrir automaticamente a URL do arquivo PAC usando consultas DHCP e DNS para a rede local.
WINHTTP_AUTOPROXY_CONFIG_URL
 Baixe o arquivo PAC da URL especificada por lpszAutoConfigUrl na estrutura WINHTTP_AUTOPROXY_OPTIONS .
WINHTTP_AUTOPROXY_HOST_KEEPCASE
 Mantém o caso dos nomes de host passados para o script PAC. Esse é o comportamento padrão.
WINHTTP_AUTOPROXY_HOST_LOWERCASE
 Converte nomes de host em letras minúsculas antes de passá-los para o script PAC.
WINHTTP_AUTOPROXY_NO_CACHE_CLIENT
 Desabilita a consulta de um host ao cache de proxy dos resultados da execução do script no processo atual.
WINHTTP_AUTOPROXY_NO_CACHE_SVC
 Desabilita a consulta de um host ao cache de proxy dos resultados de execução de script no serviço de reprodução automática.
WINHTTP_AUTOPROXY_NO_DIRECTACCESS
 Desabilita a consulta de configurações de proxy de Acesso Direto para essa solicitação.
WINHTTP_AUTOPROXY_RUN_INPROCESS
 Executa o protocolo WPAD (Descoberta Automática de Proxy Web) em processo em vez de delegar a um Serviço de AutoProxiação WinHTTP fora do processo, se disponível. Esse sinalizador deve ser combinado com um dos outros sinalizadores.

Essa opção não tem efeito quando passada para WinHttpGetProxyForUrlEx.

Nota Esse sinalizador foi preterido.
 
WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY
 Por padrão, o WinHTTP é configurado para fazer fallback para descobrir automaticamente um proxy em processo. Se esse comportamento de fallback for indesejável caso uma descoberta fora do processo falhe, ele poderá ser desabilitado usando esse sinalizador.

Essa opção não tem efeito quando passada para WinHttpGetProxyForUrlEx.

Nota Esse sinalizador está disponível apenas no Windows Server 2003.
 
WINHTTP_AUTOPROXY_SORT_RESULTS
Ordena os resultados do proxy com base em uma heurística colocando os proxies mais rápidos primeiro.

dwAutoDetectFlags

Se dwFlags incluir o sinalizador WINHTTP_AUTOPROXY_AUTO_DETECT, dwAutoDetectFlags especificará quais protocolos devem ser usados para localizar o arquivo PAC. Se os sinalizadores de detecção automática DHCP e DNS forem especificados, o DHCP será usado primeiro; se nenhuma URL PAC for descoberta usando DHCP, o DNS será usado.

Se dwFlags não incluir o sinalizador WINHTTP_AUTOPROXY_AUTO_DETECT, dwAutoDetectFlags deverá ser zero.

Valor Significado
WINHTTP_AUTO_DETECT_TYPE_DHCP
 Use o DHCP para localizar o arquivo de configuração automática do proxy.
WINHTTP_AUTO_DETECT_TYPE_DNS_A
 Use o DNS para tentar localizar o arquivo de configuração automática do proxy em um local conhecido no domínio do computador local.

lpszAutoConfigUrl

Se dwFlags incluir o sinalizador de WINHTTP_AUTOPROXY_CONFIG_URL, o lpszAutoConfigUrl deverá apontar para uma cadeia de caracteres Unicode terminada em nulo que contenha a URL do arquivo PAC (configuração automática do proxy).

Se dwFlags não incluir o sinalizador WINHTTP_AUTOPROXY_CONFIG_URL, lpszAutoConfigUrl deverá ser NULL.

lpvReserved

Reservado para uso futuro; deve ser NULL.

dwReserved

Reservado para uso futuro; deve ser zero.

fAutoLogonIfChallenged

Especifica se as credenciais de domínio do cliente devem ser enviadas automaticamente em resposta a um desafio NTLM ou Negociar Autenticação quando WinHTTP solicita o arquivo PAC.

Se esse sinalizador for TRUE, as credenciais deverão ser enviadas automaticamente em resposta a um desafio de autenticação. Se esse sinalizador for FALSE e a autenticação for necessária para baixar o arquivo PAC, a função WinHttpGetProxyForUrl falhará.

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]
Cabeçalho winhttp.h

Confira também

Versões do WinHTTP