Funzione WinHttpResetAutoProxy (winhttp.h)

Articolo
08/27/2023

La funzione WinHttpResetAutoProxy reimposta il proxy automatico.

Sintassi

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

Parametri

[in] hSession

Handle di sessione WINHTTP DI WINHTTP VALIDO restituito da una chiamata precedente alla funzione WinHttpOpen .

[in] dwFlags

Set di flag che influiscono sull'operazione di reimpostazione.

I flag seguenti sono supportati come definito nel file di intestazione Winhttp.h .

Valore	Significato
WINHTTP_RESET_STATE 0x00000001	Forza uno scaricamento e un nuovo tentativo di informazioni sul proxy non persistente nella rete corrente.
WINHTTP_RESET_SWPAD_CURRENT_NETWORK 0x00000002	Scaricare le informazioni PAD per la rete corrente.
WINHTTP_RESET_SWPAD_ALL 0x00000004	Scaricare le informazioni PAD per tutte le reti.
WINHTTP_RESET_SCRIPT_CACHE 0x00000008	Scaricare la cache HTTP persistente degli script proxy.
WINHTTP_RESET_ALL 0x0000FFFF	Forza uno scaricamento e un nuovo tentativo di tutte le informazioni sul proxy nella rete corrente.
WINHTTP_RESET_NOTIFY_NETWORK_CHANGED 0x00010000	Scaricare le informazioni sul proxy correnti e notificare che la rete è cambiata.
WINHTTP_RESET_OUT_OF_PROC 0x00020000	Agire sul servizio autoproxy anziché sul processo corrente. Nota Questo flag è obbligatorio. Le applicazioni che usano la funzione WinHttpGetProxyForUrl per eliminare la memorizzazione nella cache in-process devono chiudere l'handle hInternet e aprire un nuovo handle per le chiamate future.

Valore restituito

Codice che indica l'esito positivo o negativo dell'operazione.

Codice restituito	Descrizione
ERROR_SUCCESS	L'operazione è stata completata.
ERROR_INVALID_HANDLE	Il parametro hSession non è un handle valido.
ERROR_WINHTTP_INCORRECT_HANDLE TYPE	Il parametro hSession non è il prodotto di una chiamata a WinHttpOpen.

Commenti

Per reimpostare tutti gli elementi, impostare il parametro dwFlags per includere WINHTTP_RESET_ALL e WINHTTP_RESET_OUT_OF_PROC.

Nota Se si effettuano chiamate successive alla funzione WinHttpResetAutoProxy , è necessario attendere almeno 30 secondi tra le chiamate per reimpostare lo stato del proxy automatico. Se sono presenti meno di 30 secondi, la chiamata di funzione WinHttpResetAutoProxy potrebbe restituire ERROR_SUCCESS ma la reimpostazione non verrà eseguita.

Requisiti


Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winhttp.h
Libreria	Winhttp.lib
DLL	Winhttp.dll

Condividi tramite