WinHttpSetDefaultProxyConfiguration-Funktion (winhttp.h)

Artikel
08/27/2023

Wichtig

Die Verwendung von WinHttpSetDefaultProxyConfiguration ist auf Windows 8.1 und höher veraltet. Die meisten Proxykonfigurationen werden von WinHttpSetDefaultProxyConfiguration nicht unterstützt und auch keine Proxyauthentifizierung unterstützt. Verwenden Sie stattdessen WINHTTP_ACCESS_TYPE_AUTOMATIC_PROXY mit WinHttpOpen.

Die WinHttpSetDefaultProxyConfiguration-Funktion legt die Standardmäßige WinHTTP-Proxykonfiguration in der Registrierung fest.

Syntax

WINHTTPAPI BOOL WinHttpSetDefaultProxyConfiguration(
  [in] WINHTTP_PROXY_INFO *pProxyInfo
);

Parameter

[in] pProxyInfo

Ein Zeiger auf eine Variable vom Typ WINHTTP_PROXY_INFO , die die Standardproxykonfiguration angibt.

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE . Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten. Zu den zurückgegebenen Fehlercodes gehören die folgenden.

Fehlercode	BESCHREIBUNG
ERROR_WINHTTP_INTERNAL_ERROR	Ein interner Fehler ist aufgetreten.
ERROR_NOT_ENOUGH_MEMORY	Für den angeforderten Vorgang war nicht genügend Arbeitsspeicher verfügbar. (Windows-Fehlercode)

Hinweise

Die von WinHttpSetDefaultProxyConfiguration festgelegte Standardproxykonfiguration kann für eine vorhandene WinHTTP-Sitzung überschrieben werden, indem WinHttpSetOption aufgerufen und das WINHTTP_OPTION_PROXY-Flag angegeben wird. Die Standardproxykonfiguration kann für eine neue Sitzung überschrieben werden, indem Sie die Konfiguration mit der WinHttpOpen-Funktion angeben.

Das dwAccessType-Element der WINHTTP_PROXY_INFO Struktur, auf die von pProxyInfo verwiesen wird, sollte auf WINHTTP_ACCESS_TYPE_NAMED_PROXY festgelegt werden, wenn ein Proxy angegeben ist. Andernfalls sollte er auf WINHTTP_ACCESS_TYPE_DEFAULT_PROXY festgelegt werden.

Alle neuen Sitzungen, die nach dem Aufrufen dieser Funktion erstellt werden, verwenden die neue Standardproxykonfiguration.

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.

Hinweis Informationen zu Windows XP und Windows 2000 finden Sie im Abschnitt Laufzeitanforderungen der WinHTTP-Startseite .

Beispiele

Das folgende Codebeispiel zeigt, wie die Standardproxykonfiguration in der Registrierung festgelegt wird.

WINHTTP_PROXY_INFO proxyInfo;

// Allocate memory for string members.
proxyInfo.lpszProxy = new WCHAR[25];
proxyInfo.lpszProxyBypass = new WCHAR[25];

// Set the members of the proxy info structure.
proxyInfo.dwAccessType = WINHTTP_ACCESS_TYPE_NAMED_PROXY;
swprintf_s(proxyInfo.lpszProxy, 25, L"proxy_server");
swprintf_s(proxyInfo.lpszProxyBypass, 25, L"<local>");

// Set the default proxy configuration.
if (WinHttpSetDefaultProxyConfiguration( &proxyInfo ))
    printf("Proxy Configuration Set.\n");

// Free memory allocated to the strings.
delete [] proxyInfo.lpszProxy;
delete [] 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.

Weitere Informationen

WinHTTP-Versionen

WinHttpGetDefaultProxyConfiguration

Freigeben über