estructura WINHTTP_AUTOPROXY_OPTIONS (winhttp.h)

  • Artículo

La estructura WINHTTP_AUTOPROXY_OPTIONS se usa para indicar a la función WinHttpGetProxyForURL si se debe especificar la dirección URL del archivo de configuración automática de proxy (PAC) o buscar automáticamente la dirección URL con consultas DHCP o DNS en la red.

Sintaxis

typedef struct _WINHTTP_AUTOPROXY_OPTIONS {
  DWORD   dwFlags;
  DWORD   dwAutoDetectFlags;
  LPCWSTR lpszAutoConfigUrl;
  LPVOID  lpvReserved;
  DWORD   dwReserved;
  BOOL    fAutoLogonIfChallenged;
} WINHTTP_AUTOPROXY_OPTIONS, *PWINHTTP_AUTOPROXY_OPTIONS;

Miembros

dwFlags

Los mecanismos deben usarse para obtener el archivo PAC.

Valor Significado
WINHTTP_AUTOPROXY_ALLOW_AUTOCONFIG
 Habilita la detección de proxy a través de la dirección URL de configuración automática.
 
Nota La compatibilidad con esta marca se introdujo en Windows 10, versión 1703 (10.0; Compilación 15063).
 
WINHTTP_AUTOPROXY_ALLOW_CM
 Habilita la detección de proxy a través del administrador de conexiones.
 
Nota La compatibilidad con esta marca se introdujo en Windows 10, versión 1703 (10.0; Compilación 15063).
 
WINHTTP_AUTOPROXY_ALLOW_STATIC
 Habilita la detección de proxy a través de la configuración estática.
 
Nota La compatibilidad con esta marca se introdujo en Windows 10, versión 1703 (10.0; Compilación 15063).
 
WINHTTP_AUTOPROXY_AUTO_DETECT
 Intente detectar automáticamente la dirección URL del archivo PAC mediante consultas DHCP y DNS en la red local.
WINHTTP_AUTOPROXY_CONFIG_URL
 Descargue el archivo PAC de la dirección URL especificada por lpszAutoConfigUrl en la estructura WINHTTP_AUTOPROXY_OPTIONS .
WINHTTP_AUTOPROXY_HOST_KEEPCASE
 Mantiene el caso de los nombres de host pasados al script PAC. Este es el comportamiento predeterminado.
WINHTTP_AUTOPROXY_HOST_LOWERCASE
 Convierte los nombres de host en minúsculas antes de pasarlos al script PAC.
WINHTTP_AUTOPROXY_NO_CACHE_CLIENT
 Deshabilita la consulta de un host para que la caché de proxy de la ejecución de scripts produzca resultados en el proceso actual.
WINHTTP_AUTOPROXY_NO_CACHE_SVC
 Deshabilita la consulta de un host para la caché de proxy de los resultados de ejecución de scripts en el servicio autoproxy.
WINHTTP_AUTOPROXY_NO_DIRECTACCESS
 Deshabilita la consulta de la configuración del proxy de acceso directo para esta solicitud.
WINHTTP_AUTOPROXY_RUN_INPROCESS
 Ejecuta el protocolo de detección automática de proxy web (WPAD) en proceso en lugar de delegarlo en un servicio WinHTTP AutoProxy fuera de proceso, si está disponible. Esta marca debe combinarse con una de las otras marcas.

Esta opción no tiene ningún efecto cuando se pasa a WinHttpGetProxyForUrlEx.

Nota Esta marca está en desuso.
 
WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY
 De forma predeterminada, WinHTTP está configurado para revertir a la detección automática de un proxy en proceso. Si este comportamiento de reserva no es deseable en caso de que se produzca un error en la detección fuera del proceso, se puede deshabilitar con esta marca.

Esta opción no tiene ningún efecto cuando se pasa a WinHttpGetProxyForUrlEx.

Nota Esta marca solo está disponible en Windows Server 2003.
 
WINHTTP_AUTOPROXY_SORT_RESULTS
Ordena los resultados del proxy en función de una heurística colocando primero los servidores proxy más rápidos.

dwAutoDetectFlags

Si dwFlags incluye la marca WINHTTP_AUTOPROXY_AUTO_DETECT, dwAutoDetectFlags especifica qué protocolos se usarán para buscar el archivo PAC. Si se especifican las marcas dhcp y DNS de detección automática, primero se usa DHCP; Si no se detecta ninguna dirección URL de PAC mediante DHCP, se usa DNS.

Si dwFlags no incluye la marca WINHTTP_AUTOPROXY_AUTO_DETECT, dwAutoDetectFlags debe ser cero.

Valor Significado
WINHTTP_AUTO_DETECT_TYPE_DHCP
 Use DHCP para buscar el archivo de configuración automática del proxy.
WINHTTP_AUTO_DETECT_TYPE_DNS_A
 Use DNS para intentar localizar el archivo de configuración automática del proxy en una ubicación conocida en el dominio del equipo local.

lpszAutoConfigUrl

Si dwFlags incluye la marca WINHTTP_AUTOPROXY_CONFIG_URL, lpszAutoConfigUrl debe apuntar a una cadena Unicode terminada en null que contenga la dirección URL del archivo de configuración automática del proxy (PAC).

Si dwFlags no incluye la marca WINHTTP_AUTOPROXY_CONFIG_URL, lpszAutoConfigUrl debe ser NULL.

lpvReserved

Reservado para uso futuro; debe ser NULL.

dwReserved

Reservado para uso futuro; debe ser cero.

fAutoLogonIfChallenged

Especifica si las credenciales de dominio del cliente se deben enviar automáticamente en respuesta a un desafío de autenticación NTLM o Negotiate cuando WinHTTP solicita el archivo PAC.

Si esta marca es TRUE, las credenciales se deben enviar automáticamente en respuesta a un desafío de autenticación. Si esta marca es FALSE y se requiere autenticación para descargar el archivo PAC, se produce un error en la función WinHttpGetProxyForUrl .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP, Windows 2000 Professional con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003, Windows 2000 Server con SP3 [solo aplicaciones de escritorio]
Encabezado winhttp.h

Consulte también

Versiones de WinHTTP