次の方法で共有

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 TYPE
 hSession パラメーターは、WinHttpOpen の呼び出しの積ではありません。

解説

すべてをリセットするには、 dwFlags パラメーターを 設定して、WINHTTP_RESET_ALLとWINHTTP_RESET_OUT_OF_PROC を含 めます。

メモWinHttpResetAutoProxy 関数の後続の呼び出しを行う場合、自動プロキシの状態をリセットするには、呼び出しの間に少なくとも 30 秒の遅延が発生する必要があります。 30 秒未満の場合、 WinHttpResetAutoProxy 関数呼び出しは ERROR_SUCCESS を返す可能性がありますが、リセットは行われません。
 

要件

   
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winhttp.h
Library Winhttp.lib
[DLL] Winhttp.dll