WinHttpResetAutoProxy 函数 (winhttp.h)

WinHttpResetAutoProxy 函数重置自动代理。

语法

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

[in] hSession

由上一次调用 WinHttpOpen 函数返回的有效 HINTERNET WinHTTP 会话句柄。

[in] dwFlags

影响重置操作的一组标志。

支持 Winhttp.h 头文件中定义的以下标志。

值	含义
WINHTTP_RESET_STATE 0x00000001	强制刷新和重试当前网络上的非持久性代理信息。
WINHTTP_RESET_SWPAD_CURRENT_NETWORK 0x00000002	刷新当前网络的 PAD 信息。
WINHTTP_RESET_SWPAD_ALL 0x00000004	刷新所有网络的 PAD 信息。
WINHTTP_RESET_SCRIPT_CACHE 0x00000008	刷新代理脚本的持久 HTTP 缓存。
WINHTTP_RESET_ALL 0x0000FFFF	强制刷新并重试当前网络上的所有代理信息。
WINHTTP_RESET_NOTIFY_NETWORK_CHANGED 0x00010000	刷新当前代理信息并通知网络已更改。
WINHTTP_RESET_OUT_OF_PROC 0x00020000	对 autoproxy 服务而不是当前进程执行操作。注意此标志是必需的。使用 WinHttpGetProxyForUrl 函数清除进程内缓存的应用程序应关闭 hInternet 句柄并打开一个新句柄以供将来调用。

指示操作成功或失败的代码。

返回代码	说明
ERROR_SUCCESS	操作成功。
ERROR_INVALID_HANDLE	hSession 参数不是有效的句柄。
ERROR_WINHTTP_INCORRECT_HANDLE类型	hSession 参数不是调用 WinHttpOpen 的乘积。

若要重置所有内容，请将 dwFlags 参数设置为包含 WINHTTP_RESET_ALL 和 WINHTTP_RESET_OUT_OF_PROC。

注意如果对 WinHttpResetAutoProxy 函数进行后续调用，则重置自动代理状态的调用之间必须至少有 30 秒的延迟。如果少于 30 秒， WinHttpResetAutoProxy 函数调用可能会返回 ERROR_SUCCESS 但不会进行重置。