Función WinHttpGetIEProxyConfigForCurrentUser (winhttp.h)

La función WinHttpGetIEProxyConfigForCurrentUser recupera la configuración del proxy de Internet Explorer para el usuario actual.

Sintaxis

WINHTTPAPI BOOL WinHttpGetIEProxyConfigForCurrentUser(
  [in, out] WINHTTP_CURRENT_USER_IE_PROXY_CONFIG *pProxyConfig
);

Parámetros

[in, out] pProxyConfig

Puntero, en la entrada, a una estructura de WINHTTP_CURRENT_USER_IE_PROXY_CONFIG . En la salida, la estructura contiene la configuración del proxy de Internet Explorer para la conexión de red activa actual (por ejemplo, LAN, acceso telefónico o conexión VPN).

Valor devuelto

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario. Para obtener información de error extendida, llame a GetLastError. Entre los códigos de error devueltos se incluyen los siguientes.

Código de error Descripción
ERROR_FILE_NOT_FOUND
No se puede encontrar ninguna configuración de proxy de Internet Explorer.
ERROR_WINHTTP_INTERNAL_ERROR
Se ha producido un error interno.
ERROR_NOT_ENOUGH_MEMORY
No había suficiente memoria disponible para completar la operación solicitada. (Código de error de Windows)

Comentarios

En Internet Explorer, la configuración de proxy se encuentra en la pestaña Conexiones de la opción de menú Herramientas / Opciones de Internet . Las opciones de proxy se configuran por conexión; es decir, la configuración de proxy para una conexión LAN es independiente de la de una conexión VPN o de acceso telefónico. WinHttpGetIEProxyConfigForCurrentUser devuelve la configuración del proxy para la conexión activa actual.

Esta función es útil en las aplicaciones cliente que se ejecutan en entornos de red en los que el protocolo de detección automática de proxy web (WPAD) no se implementa (lo que significa que no hay ningún archivo de configuración automática de proxy disponible). Si un archivo PAC no está disponible, se produce un error en la función WinHttpGetProxyForUrl . La función WinHttpGetIEProxyConfigForCurrentUser se puede usar como mecanismo de reserva para detectar una configuración de proxy que funcione recuperando la configuración de proxy del usuario en Internet Explorer.

Esta función no se debe usar en un proceso de servicio que no suplanta a un usuario que ha iniciado sesión. Si el autor de la llamada no suplanta a un usuario que ha iniciado sesión, WinHTTP intenta recuperar la configuración de Internet Explorer para el proceso de servicio actual: por ejemplo, el servicio local o el servicio de red. Si la configuración de Internet Explorer no está configurada para estas cuentas del sistema, se producirá un error en la llamada a WinHttpGetIEProxyConfigForCurrentUser .

El autor de la llamada debe liberar las cadenas lpszProxy, lpszProxyBypass y lpszAutoConfigUrl en la estructura WINHTTP_CURRENT_USER_IE_PROXY_CONFIG si no son NULL. Use GlobalFree para liberar las cadenas.

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 winHTTP