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:
| Fehlercode | BESCHREIBUNG |
|---|---|
|
Ein interner Fehler ist aufgetreten. |
|
Für den angeforderten Vorgang war nicht genügend Arbeitsspeicher verfügbar. (Windows-Fehlercode) |
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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winhttp.h |
| Bibliothek | Winhttp.lib |
| DLL | Winhttp.dll |
| Verteilbare Komponente | WinHTTP 5.0 und Internet Explorer 5.01 oder höher unter Windows XP und Windows 2000. |