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 WINHTTP_CURRENT_USER_IE_PROXY_CONFIG . En la salida, la estructura contiene la configuración de 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 es correcto o FALSE en caso contrario. Para obtener información de error extendida, llame a GetLastError. Entre los códigos de error devueltos se encuentran los siguientes.
| Código de error | Descripción |
|---|---|
|
No se encuentra ninguna configuración de proxy de Internet Explorer. |
|
Se ha producido un error interno. |
|
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 . Los valores de proxy se configuran por conexión; es decir, la configuración de proxy de una conexión LAN es independiente de la de una conexión de acceso telefónico o VPN. WinHttpGetIEProxyConfigForCurrentUser devuelve la configuración de 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 activable 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 |