Compartir a través de

Función WinHttpResetAutoProxy (winhttp.h)

  • Artículo

La función WinHttpResetAutoProxy restablece el proxy automático.

Sintaxis

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

Parámetros

[in] hSession

Identificador de sesión WinHTTP de HINTERNET válido devuelto por una llamada anterior a la función WinHttpOpen .

[in] dwFlags

Conjunto de marcas que afecta a la operación de restablecimiento.

Las marcas siguientes se admiten como se define en el archivo de encabezado Winhttp.h .

Value Significado
WINHTTP_RESET_STATE
0x00000001
 Fuerza un vaciado y reintento de información de proxy no persistente en la red actual.
WINHTTP_RESET_SWPAD_CURRENT_NETWORK
0x00000002
 Vacíe la información de PAD de la red actual.
WINHTTP_RESET_SWPAD_ALL
0x00000004
 Vacíe la información del PAD para todas las redes.
WINHTTP_RESET_SCRIPT_CACHE
0x00000008
 Vacíe la caché HTTP persistente de scripts de proxy.
WINHTTP_RESET_ALL
0x0000FFFF
 Fuerza un vaciado y reintento de toda la información de proxy en la red actual.
WINHTTP_RESET_NOTIFY_NETWORK_CHANGED
0x00010000
 Vacíe la información del proxy actual y notifique que la red ha cambiado.
WINHTTP_RESET_OUT_OF_PROC
0x00020000
 Actúe en el servicio autoproxy en lugar del proceso actual.
Nota Esta marca es necesaria.
 

Las aplicaciones que usan la función WinHttpGetProxyForUrl para purgar el almacenamiento en caché en proceso deben cerrar el identificador hInternet y abrir un nuevo identificador para futuras llamadas.

Valor devuelto

Código que indica el éxito o error de la operación.

Código devuelto Descripción
ERROR_SUCCESS
 La operación se realizó correctamente.
ERROR_INVALID_HANDLE
 El parámetro hSession no es un identificador válido.
ERROR_WINHTTP_INCORRECT_HANDLE TYPE
 El parámetro hSession no es el producto de una llamada a WinHttpOpen.

Comentarios

Para restablecer todo, establezca el parámetro dwFlags para incluir WINHTTP_RESET_ALL y WINHTTP_RESET_OUT_OF_PROC.

Nota Si realiza llamadas posteriores a la función WinHttpResetAutoProxy , debe haber al menos 30 segundos de retraso entre las llamadas para restablecer el estado del proxy automático. Si hay menos de 30 segundos, la llamada de función WinHttpResetAutoProxy puede devolver ERROR_SUCCESS , pero el restablecimiento no se producirá.
 

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winhttp.h
Library Winhttp.lib
Archivo DLL Winhttp.dll