WinHttpGetIEProxyConfigForCurrentUser-Funktion (winhttp.h)

  • Artikel

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
ERROR_FILE_NOT_FOUND
 Es können keine Internet-Explorer Proxyeinstellungen gefunden werden.
ERROR_WINHTTP_INTERNAL_ERROR
 Ein interner Fehler ist aufgetreten.
ERROR_NOT_ENOUGH_MEMORY
 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

Weitere Informationen

WinHTTP-Versionen