WinHttpResetAutoProxy-Funktion (winhttp.h)

Artikel
08/27/2023

Die WinHttpResetAutoProxy-Funktion setzt den automatischen Proxy zurück.

Syntax

WINHTTPAPI DWORD WinHttpResetAutoProxy(
  [in] HINTERNET hSession,
  [in] DWORD     dwFlags
);

Parameter

[in] hSession

Ein gültiges HINTERNET WinHTTP-Sitzungshandle, das von einem vorherigen Aufruf der WinHttpOpen-Funktion zurückgegeben wurde.

[in] dwFlags

Ein Satz von Flags, die sich auf den Zurücksetzungsvorgang auswirken.

Die folgenden Flags werden wie in der Winhttp.h-Headerdatei definiert unterstützt.

Wert	Bedeutung
WINHTTP_RESET_STATE 0x00000001	Erzwingt eine Leerung und wiederholung von nicht persistenten Proxyinformationen im aktuellen Netzwerk.
WINHTTP_RESET_SWPAD_CURRENT_NETWORK 0x00000002	Leeren Sie die PAD-Informationen für das aktuelle Netzwerk.
WINHTTP_RESET_SWPAD_ALL 0x00000004	Leeren Sie die PAD-Informationen für alle Netzwerke.
WINHTTP_RESET_SCRIPT_CACHE 0x00000008	Leeren Sie den persistenten HTTP-Cache von Proxyskripts.
WINHTTP_RESET_ALL 0x0000FFFF	Erzwingt eine Leerung und einen Wiederholungsversuch aller Proxyinformationen im aktuellen Netzwerk.
WINHTTP_RESET_NOTIFY_NETWORK_CHANGED 0x00010000	Leeren Sie die aktuellen Proxyinformationen, und benachrichtigen Sie, dass sich das Netzwerk geändert hat.
WINHTTP_RESET_OUT_OF_PROC 0x00020000	Reagieren Sie auf den AutoProxy-Dienst anstelle des aktuellen Prozesses. Hinweis Dieses Flag ist erforderlich. Anwendungen, die die WinHttpGetProxyForUrl-Funktion zum Löschen der Prozesszwischenspeicherung verwenden, sollten das hInternet-Handle schließen und ein neues Handle für zukünftige Aufrufe öffnen.

Rückgabewert

Ein Code, der den Erfolg oder Fehler des Vorgangs angibt.

Rückgabecode	Beschreibung
ERROR_SUCCESS	Der Vorgang wurde durchgeführt.
ERROR_INVALID_HANDLE	Der hSession-Parameter ist kein gültiges Handle.
ERROR_WINHTTP_INCORRECT_HANDLE TYP	Der hSession-Parameter ist nicht das Produkt eines Aufrufs von WinHttpOpen.

Hinweise

Um alles zurückzusetzen, legen Sie den dwFlags-Parameter so fest, dass er WINHTTP_RESET_ALL und WINHTTP_RESET_OUT_OF_PROC enthält.

Hinweis Wenn Sie nachfolgende Aufrufe der WinHttpResetAutoProxy-Funktion durchführen, muss es mindestens 30 Sekunden Verzögerung zwischen den Aufrufen geben, um den Status des automatischen Proxys zurückzusetzen. Wenn weniger als 30 Sekunden dauern, gibt der WinHttpResetAutoProxy-Funktionsaufruf möglicherweise ERROR_SUCCESS zurück, aber das Zurücksetzen erfolgt nicht.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winhttp.h
Bibliothek	Winhttp.lib
DLL	Winhttp.dll

Freigeben über