WinHttpResetAutoProxy 函式 (winHTTP.h)

WinHttpResetAutoProxy函式會重設自動 Proxy。

語法

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

[in] hSession

先前呼叫WinHttpOpen函式所傳回的有效HINTERNET WinHTTP 會話控制碼。

[in] dwFlags

一組會影響重設作業的旗標。

WinHTTP.h標頭檔中定義支援下列旗標。

值	意義
WINHTTP_RESET_STATE 0x00000001	強制清除並重試目前網路上的非持續性 Proxy 資訊。
WINHTTP_RESET_SWPAD_CURRENT_NETWORK 0x00000002	排清目前網路的 PAD 資訊。
WINHTTP_RESET_SWPAD_ALL 0x00000004	排清所有網路的 PAD 資訊。
WINHTTP_RESET_SCRIPT_CACHE 0x00000008	排清 Proxy 腳本的持續性 HTTP 快取。
WINHTTP_RESET_ALL 0x0000FFFF	強制清除並重試目前網路上的所有 Proxy 資訊。
WINHTTP_RESET_NOTIFY_NETWORK_CHANGED 0x00010000	排清目前的 Proxy 資訊，並通知網路已變更。
WINHTTP_RESET_OUT_OF_PROC 0x00020000	對 autoproxy 服務採取行動，而不是目前的程式。注意這是必要旗標。使用 WinHttpGetProxyForUrl 函式清除進程內快取的應用程式應該關閉 hInternet 控制碼，並開啟新的控制碼以供日後呼叫。

指出作業成功或失敗的程式碼。

傳回碼	描述
ERROR_SUCCESS	作業成功。
ERROR_INVALID_HANDLE	hSession參數不是有效的控制碼。
ERROR_WINHTTP_INCORRECT_HANDLE TYPE	hSession參數不是WinHttpOpen呼叫的乘積。

若要重設所有專案，請將 dwFlags 參數設定為包含 WINHTTP_RESET_ALL 和 WINHTTP_RESET_OUT_OF_PROC。

注意如果您對 WinHttpResetAutoProxy 函式進行後續呼叫，呼叫之間必須至少有 30 秒的延遲，才能重設自動 Proxy 的狀態。如果少於 30 秒， WinHttpResetAutoProxy 函式呼叫可能會傳回 ERROR_SUCCESS 但不會重設。