Compartilhar via

Função WinHttpResetAutoProxy (winhttp.h)

  • Artigo

A função WinHttpResetAutoProxy redefine o proxy automático.

Sintaxe

WINHTTPAPI DWORD WinHttpResetAutoProxy(
  [in] HINTERNET hSession,
  [in] DWORD     dwFlags
);

Parâmetros

[in] hSession

Um identificador de sessão HINTERNET WinHTTP válido retornado por uma chamada anterior para a função WinHttpOpen .

[in] dwFlags

Um conjunto de sinalizadores que afeta a operação de redefinição.

Os sinalizadores a seguir têm suporte, conforme definido no arquivo de cabeçalho Winhttp.h .

Valor Significado
WINHTTP_RESET_STATE
0x00000001
 Força uma liberação e uma nova tentativa de informações de proxy não persistentes na rede atual.
WINHTTP_RESET_SWPAD_CURRENT_NETWORK
0x00000002
 Libere as informações do PAD para a rede atual.
WINHTTP_RESET_SWPAD_ALL
0x00000004
 Libere as informações do PAD para todas as redes.
WINHTTP_RESET_SCRIPT_CACHE
0x00000008
 Libere o cache HTTP persistente de scripts proxy.
WINHTTP_RESET_ALL
0x0000FFFF
 Força uma liberação e uma nova tentativa de todas as informações de proxy na rede atual.
WINHTTP_RESET_NOTIFY_NETWORK_CHANGED
0x00010000
 Libere as informações de proxy atuais e notifique que a rede foi alterada.
WINHTTP_RESET_OUT_OF_PROC
0x00020000
 Atue no serviço de reprodução automática em vez do processo atual.
Nota Esse sinalizador é necessário.
 

Os aplicativos que usam a função WinHttpGetProxyForUrl para limpar o cache em processo devem fechar o identificador hInternet e abrir um novo identificador para chamadas futuras.

Valor retornado

Um código que indica o êxito ou a falha da operação.

Código de retorno Descrição
ERROR_SUCCESS
 A operação foi bem-sucedida.
ERROR_INVALID_HANDLE
 O parâmetro hSession não é um identificador válido.
ERROR_WINHTTP_INCORRECT_HANDLE TYPE
 O parâmetro hSession não é o produto de uma chamada para WinHttpOpen.

Comentários

Para redefinir tudo, defina o parâmetro dwFlags para incluir WINHTTP_RESET_ALL e WINHTTP_RESET_OUT_OF_PROC.

Nota Se você fizer chamadas subsequentes para a função WinHttpResetAutoProxy , deverá haver pelo menos 30 segundos de atraso entre as chamadas para redefinir o estado do proxy automático. Se houver menos de 30 segundos, a chamada de função WinHttpResetAutoProxy poderá retornar ERROR_SUCCESS mas a redefinição não acontecerá.
 

Requisitos

   
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winhttp.h
Biblioteca Winhttp.lib
DLL Winhttp.dll