Função WinHttpGetIEProxyConfigForCurrentUser (winhttp.h)

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.

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

Confira também

Versões do WinHTTP