Função WinHttpDetectAutoProxyConfigUrl (winhttp.h)

  • Artigo

A função WinHttpDetectAutoProxyConfigUrl localiza a URL do arquivo PAC (Configuração Automática de Proxy). Essa função relata a URL do arquivo PAC, mas não baixa o arquivo.

Sintaxe

WINHTTPAPI BOOL WinHttpDetectAutoProxyConfigUrl(
  [in]  DWORD  dwAutoDetectFlags,
  [out] LPWSTR *ppwstrAutoConfigUrl
);

Parâmetros

[in] dwAutoDetectFlags

Um tipo de dados que especifica quais protocolos usar para localizar o arquivo PAC. Se os sinalizadores de detecção automática DHCP e DNS estiverem definidos, o DHCP será usado primeiro; se nenhuma URL PAC for descoberta usando DHCP, o DNS será usado.

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.

[out] ppwstrAutoConfigUrl

Um tipo de dados que retorna um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém a URL de configuração que recebe os dados do proxy. Você deve liberar a cadeia de caracteres apontada por ppwszAutoConfigUrl usando a função GlobalFree .

Valor retornado

Retorna 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_WINHTTP_AUTODETECTION_FAILED
 Retornado se o WinHTTP não conseguiu descobrir a URL do arquivo PAC (Configuração Automática de Proxy).
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

O WinHTTP implementa o protocolo WPAD (Descoberta Automática de Proxy Web), geralmente chamado de autoproxia. Para obter mais informações sobre locais conhecidos, consulte a seção Processo de Descoberta do documento de protocolo WPAD.

Observe que, como a função WinHttpDetectAutoProxyConfigUrl leva tempo para concluir sua operação, ela não deve ser chamada de um thread de interface do usuário.

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