Función WinHttpGetProxyForUrl (winhttp.h)

La función WinHttpGetProxyForUrl recupera los datos de proxy de la dirección URL especificada.

Sintaxis

WINHTTPAPI BOOL WinHttpGetProxyForUrl(
  [in]  HINTERNET                 hSession,
  [in]  LPCWSTR                   lpcwszUrl,
  [in]  WINHTTP_AUTOPROXY_OPTIONS *pAutoProxyOptions,
  [out] WINHTTP_PROXY_INFO        *pProxyInfo
);

Parámetros

[in] hSession

Identificador de sesión winHTTP devuelto por la función WinHttpOpen .

[in] lpcwszUrl

Puntero a una cadena Unicode terminada en null que contiene la dirección URL de la solicitud HTTP que la aplicación está preparando para enviar.

[in] pAutoProxyOptions

Puntero a una estructura de WINHTTP_AUTOPROXY_OPTIONS que especifica las opciones de proxy automático que se van a usar.

[out] pProxyInfo

Puntero a una estructura de WINHTTP_PROXY_INFO que recibe la configuración de proxy. A continuación, esta estructura se aplica al identificador de solicitud mediante la opción WINHTTP_OPTION_PROXY. Libere las cadenas lpszProxy y lpszProxyBypass contenidas en esta estructura (si no son NULL) mediante la función GlobalFree .

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve TRUE.

Si se produce un error en la función, devuelve FALSE. Para obtener datos de error extendidos, llame a GetLastError.

Entre los posibles códigos de error se incluyen el follaje.

Código de error Descripción
ERROR_WINHTTP_AUTO_PROXY_SERVICE_ERROR
Devuelto por WinHttpGetProxyForUrl cuando no se puede encontrar un proxy para la dirección URL especificada.
ERROR_WINHTTP_BAD_AUTO_PROXY_SCRIPT
Error al ejecutar el código de script en el archivo de configuración automática de proxy (PAC).
ERROR_WINHTTP_INCORRECT_HANDLE_TYPE
El tipo de identificador proporcionado es incorrecto para esta operación.
ERROR_WINHTTP_INTERNAL_ERROR
Se ha producido un error interno.
ERROR_WINHTTP_INVALID_URL
La dirección URL no es válida.
ERROR_WINHTTP_LOGIN_FAILURE
Error en el intento de inicio de sesión. Cuando se encuentre este error, cierre el identificador de solicitud con WinHttpCloseHandle. Se debe crear un nuevo identificador de solicitud antes de volver a intentar la función que generó este error originalmente.
ERROR_WINHTTP_OPERATION_CANCELLED
La operación se canceló, normalmente porque el identificador en el que estaba funcionando la solicitud se cerró antes de que se completara la operación.
ERROR_WINHTTP_UNABLE_TO_DOWNLOAD_SCRIPT
No se pudo descargar el archivo PAC. Por ejemplo, es posible que el servidor al que hace referencia la dirección URL de PAC no haya sido accesible o el servidor devolvió una respuesta 404 NOT FOUND.
ERROR_WINHTTP_UNRECOGNIZED_SCHEME
La dirección URL del archivo PAC especificó un esquema distinto de "http:" o "https:".
ERROR_NOT_ENOUGH_MEMORY
No había suficiente memoria disponible para completar la operación solicitada. (Código de error de Windows)

Comentarios

Esta función implementa el protocolo de detección automática de proxy web (WPAD) para configurar automáticamente la configuración del proxy para una solicitud HTTP. El protocolo WPAD descarga un archivo de configuración automática de proxy (PAC), que es un script que identifica el servidor proxy que se va a usar para una dirección URL de destino determinada. Normalmente, el departamento de TI implementa los archivos PAC dentro de un entorno de red corporativa. La dirección URL del archivo PAC se puede especificar explícitamente o Se puede indicar a WinHttpGetProxyForUrl que detecte automáticamente la ubicación del archivo PAC en la red local.

WinHttpGetProxyForUrl solo admite archivos PAC basados en ECMAScript.

Se debe llamar a WinHttpGetProxyForUrl por dirección URL, ya que el archivo PAC puede devolver un servidor proxy diferente para direcciones URL diferentes. Esto resulta útil porque el archivo PAC permite a un departamento de TI implementar el equilibrio de carga del servidor proxy asignando (hash) la dirección URL de destino (especificada por el parámetro lpcwszUrl ) a un determinado proxy en una matriz de servidores proxy.

WinHttpGetProxyForUrl almacena en caché la dirección URL de autoproxy y el script de autoproxy cuando se especifica la detección automática en el miembro dwFlags de la estructura pAutoProxyOptions . Para obtener más información, consulte Autoproxy Cache.

Requisitos

   
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]
Plataforma de destino Windows
Encabezado winhttp.h
Library Winhttp.lib
Archivo DLL Winhttp.dll

Consulte también

Versiones de WinHTTP