WinHttpGetDefaultProxyConfiguration-Funktion (winhttp.h)

Die WinHttpGetDefaultProxyConfiguration-Funktion ruft die Standardmäßige WinHTTP-Proxykonfiguration aus der Registrierung ab.

Syntax

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

Parameter

[in, out] pProxyInfo

Ein Zeiger auf eine Variable vom Typ WINHTTP_PROXY_INFO , die die Standardproxykonfiguration empfängt.

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE . Um eine bestimmte Fehlermeldung abzurufen, rufen Sie GetLastError auf. Zu den zurückgegebenen Fehlercodes gehören:

Hinweise

WinHttpGetDefaultProxyConfiguration ruft den Proxykonfigurationssatz von WinHttpSetDefaultProxyConfiguration oder ProxyCfg.exeab.

Die Standardproxykonfiguration kann für eine WinHTTP-Sitzung überschrieben werden, indem WinHttpSetOption aufgerufen und das flag WINHTTP_OPTION_PROXY angegeben wird.
WinHttpGetDefaultProxyConfiguration ruft die Konfiguration für die aktuelle Sitzung nicht ab. Es ruft die in der Registrierung angegebene Konfiguration ab.

Wenn die Registrierung eine Liste von Proxyservern enthält, wird das dwAccessType-Element von pProxyInfo auf WINHTTP_ACCESS_TYPE_NAMED_PROXY festgelegt. Andernfalls ist sie auf WINHTTP_ACCESS_TYPE_NO_PROXY festgelegt.

WinHttpGetDefaultProxyConfiguration weist Arbeitsspeicher für die Zeichenfolgenmember von pProxyInfo zu. Rufen Sie GlobalFree auf, um diesen Arbeitsspeicher freizugeben.

Auch wenn WinHTTP im asynchronen Modus verwendet wird (d. h. wenn WINHTTP_FLAG_ASYNC in WinHttpOpen festgelegt wurde), arbeitet diese Funktion synchron. Der Rückgabewert weist auf Erfolg oder Fehler hin. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Beispiele

Das folgende Codebeispiel zeigt, wie die Standardproxykonfiguration aus der Registrierung abgerufen wird.

    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 );
    }

Anforderungen

Weitere Informationen

ProxyCfg.exe, ein Proxykonfigurationstool

WinHTTP-Versionen

WinHttpSetDefaultProxyConfiguration