WinHttpSetDefaultProxyConfiguration-Funktion (winhttp.h)
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 |
|---|---|
|
Ein interner Fehler ist aufgetreten. |
|
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.
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. |