Función WinHttpGetDefaultProxyConfiguration (winhttp.h)

  • Artículo

La función WinHttpGetDefaultProxyConfiguration recupera la configuración predeterminada del proxy WinHTTP del registro.

Sintaxis

WINHTTPAPI BOOL WinHttpGetDefaultProxyConfiguration(
  [in, out] WINHTTP_PROXY_INFO *pProxyInfo
);

Parámetros

[in, out] pProxyInfo

Puntero a una variable de tipo WINHTTP_PROXY_INFO que recibe la configuración de proxy predeterminada.

Valor devuelto

Devuelve TRUE si es correcto o FALSE de lo contrario. Para recuperar un mensaje de error específico, llame a GetLastError. Los códigos de error devueltos incluyen lo siguiente.

Código de error Descripción
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

WinHttpGetDefaultProxyConfiguration recupera la configuración de proxy establecida por WinHttpSetDefaultProxyConfiguration o ProxyCfg.exe.

La configuración de proxy predeterminada se puede invalidar para una sesión winHTTP llamando a WinHttpSetOption y especificando la marca de WINHTTP_OPTION_PROXY .
WinHttpGetDefaultProxyConfiguration no recupera la configuración de la sesión actual. Recupera la configuración especificada en el Registro.

Si el registro contiene una lista de servidores proxy, el miembro dwAccessType de pProxyInfo se establece en WINHTTP_ACCESS_TYPE_NAMED_PROXY. De lo contrario, se establece en WINHTTP_ACCESS_TYPE_NO_PROXY.

WinHttpGetDefaultProxyConfiguration asigna memoria para los miembros de cadena de pProxyInfo. Para liberar esta memoria, llame a GlobalFree.

Incluso cuando WinHTTP se usa en modo asincrónico (es decir, cuando WINHTTP_FLAG_ASYNC se ha establecido en WinHttpOpen), esta función funciona de forma sincrónica. El valor devuelto indica éxito o error. Para obtener información de error extendida, llame a GetLastError.

Nota Para Windows XP y Windows 2000, consulte la sección Requisitos en tiempo de ejecución de la página de inicio de WinHTTP.
 

Ejemplos

En el ejemplo de código siguiente se muestra cómo recuperar la configuración de proxy predeterminada del Registro.

    WINHTTP_PROXY_INFO proxyInfo;

    // Retrieve the default proxy configuration.
    WinHttpGetDefaultProxyConfiguration( &proxyInfo );

    // Display the proxy servers and free memory 
    // allocated to this string.
    if (proxyInfo.lpszProxy != NULL)
    {
        printf("Proxy server list: %S\n", proxyInfo.lpszProxy);
        GlobalFree( proxyInfo.lpszProxy );
    }

    // Display the bypass list and free memory 
    // allocated to this string.
    if (proxyInfo.lpszProxyBypass != NULL)
    {
        printf("Proxy bypass list: %S\n", proxyInfo.lpszProxyBypass);
        GlobalFree( proxyInfo.lpszProxyBypass );
    }

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]
Plataforma de destino Windows
Encabezado winhttp.h
Library Winhttp.lib
Archivo DLL Winhttp.dll
Redistribuible WinHTTP 5.0 e Internet Explorer 5.01 o posterior en Windows XP y Windows 2000.

Consulte también

ProxyCfg.exe, una herramienta de configuración de proxy

Versiones winHTTP

WinHttpSetDefaultProxyConfiguration