Função WinHttpGetIEProxyConfigForCurrentUser (winhttp.h)

  • Artigo

A função WinHttpGetIEProxyConfigForCurrentUser recupera a configuração de proxy de Explorer internet para o usuário atual.

Sintaxe

WINHTTPAPI BOOL WinHttpGetIEProxyConfigForCurrentUser(
  [in, out] WINHTTP_CURRENT_USER_IE_PROXY_CONFIG *pProxyConfig
);

Parâmetros

[in, out] pProxyConfig

Um ponteiro, na entrada, para uma estrutura WINHTTP_CURRENT_USER_IE_PROXY_CONFIG . Na saída, a estrutura contém as configurações de proxy de Explorer da Internet para a conexão de rede ativa atual (por exemplo, LAN, discagem ou conexão VPN).

Valor retornado

Retornará TRUE se tiver êxito ou FALSE caso contrário. Para obter informações de erro estendidas, chame GetLastError. Entre os códigos de erro retornados estão os seguintes.

Código do Erro Descrição
ERROR_FILE_NOT_FOUND
 Nenhuma configuração de proxy de Explorer da Internet pode ser encontrada.
ERROR_WINHTTP_INTERNAL_ERROR
 Ocorreu um erro interno.
ERROR_NOT_ENOUGH_MEMORY
 Não havia memória suficiente disponível para concluir a operação solicitada. (Código de erro do Windows)

Comentários

Na Internet Explorer, as configurações de proxy são encontradas na guia Conexões da opção de menu Ferramentas / opções da Internet. As configurações de proxy são definidas por conexão; ou seja, as configurações de proxy para uma conexão LAN são separadas daquelas para uma conexão vpn ou discada. WinHttpGetIEProxyConfigForCurrentUser retorna as configurações de proxy para a conexão ativa atual.

Essa função é útil em aplicativos cliente em execução em ambientes de rede nos quais o protocolo WPAD (Descoberta Automática de Proxy Web) não é implementado (o que significa que nenhum arquivo de Configuração Automática de Proxy está disponível). Se um arquivo PAC não estiver disponível, a função WinHttpGetProxyForUrl falhará. A função WinHttpGetIEProxyConfigForCurrentUser pode ser usada como um mecanismo de fallback para descobrir uma configuração de proxy viável recuperando a configuração de proxy do usuário na Internet Explorer.

Essa função não deve ser usada em um processo de serviço que não represente um usuário conectado. Se o chamador não representar um usuário conectado, o WinHTTP tentará recuperar as configurações de Explorer da Internet para o processo de serviço atual: por exemplo, o serviço local ou o serviço de rede. Se as configurações de Explorer da Internet não estiverem definidas para essas contas do sistema, a chamada para WinHttpGetIEProxyConfigForCurrentUser falhará.

O chamador deve liberar as cadeias de caracteres lpszProxy, lpszProxyBypass e lpszAutoConfigUrl na estrutura WINHTTP_CURRENT_USER_IE_PROXY_CONFIG se não forem NULL. Use GlobalFree para liberar as cadeias de caracteres.

Requisitos

   
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]
Plataforma de Destino Windows
Cabeçalho winhttp.h
Biblioteca Winhttp.lib
DLL Winhttp.dll

Confira também

Versões do WinHTTP