WinHttpGetIEProxyConfigForCurrentUser-Funktion (winhttp.h)
Die WinHttpGetIEProxyConfigForCurrentUser-Funktion ruft die Internet-Explorer Proxykonfiguration für den aktuellen Benutzer ab.
Syntax
WINHTTPAPI BOOL WinHttpGetIEProxyConfigForCurrentUser(
[in, out] WINHTTP_CURRENT_USER_IE_PROXY_CONFIG *pProxyConfig
);
Parameter
[in, out] pProxyConfig
Ein Zeiger bei der Eingabe auf eine WINHTTP_CURRENT_USER_IE_PROXY_CONFIG-Struktur . In der Ausgabe enthält die Struktur die Internet-Explorer Proxyeinstellungen für die aktuell aktive Netzwerkverbindung (z. B. LAN, Einwahl oder VPN-Verbindung).
Rückgabewert
Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE . Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten. Zu den zurückgegebenen Fehlercodes gehören die folgenden.
| Fehlercode | BESCHREIBUNG |
|---|---|
|
Es können keine Internet-Explorer Proxyeinstellungen gefunden werden. |
|
Ein interner Fehler ist aufgetreten. |
|
Es war nicht genügend Arbeitsspeicher verfügbar, um den angeforderten Vorgang abzuschließen. (Windows-Fehlercode) |
Hinweise
In internet Explorer finden Sie die Proxyeinstellungen auf der Registerkarte Verbindungen der Menüoption Extras / Internetoptionen. Proxyeinstellungen werden pro Verbindung konfiguriert. Das heißt, die Proxyeinstellungen für eine LAN-Verbindung sind von denen für eine DFÜ- oder VPN-Verbindung getrennt. WinHttpGetIEProxyConfigForCurrentUser gibt die Proxyeinstellungen für die aktuelle aktive Verbindung zurück.
Diese Funktion ist in Clientanwendungen nützlich, die in Netzwerkumgebungen ausgeführt werden, in denen das WPAD-Protokoll (Web Proxy Auto-Discovery) nicht implementiert ist (d. h. keine Proxy-Autokonfigurationsdatei verfügbar ist). Wenn keine PAC-Datei verfügbar ist, schlägt die WinHttpGetProxyForUrl-Funktion fehl. Die WinHttpGetIEProxyConfigForCurrentUser-Funktion kann als Fallbackmechanismus verwendet werden, um eine funktionsfähige Proxykonfiguration zu ermitteln, indem die Proxykonfiguration des Benutzers im Internet Explorer abgerufen wird.
Diese Funktion sollte nicht in einem Dienstprozess verwendet werden, der die Identität eines angemeldeten Benutzers nicht angibt. Wenn der Aufrufer die Identität eines angemeldeten Benutzers nicht annimmt, versucht WinHTTP, die Internet-Explorer Einstellungen für den aktuellen Dienstprozess abzurufen, z. B. den lokalen Dienst oder den Netzwerkdienst. Wenn die Einstellungen für internet Explorer nicht für diese Systemkonten konfiguriert sind, schlägt der Aufruf von WinHttpGetIEProxyConfigForCurrentUser fehl.
Der Aufrufer muss die Zeichenfolgen lpszProxy, lpszProxyBypass und lpszAutoConfigUrl in der WINHTTP_CURRENT_USER_IE_PROXY_CONFIG-Struktur freigeben, wenn sie nicht NULL sind. Verwenden Sie GlobalFree , um die Zeichenfolgen frei zu geben.
Anforderungen
| 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 |