WinHttpResetAutoProxy 関数 (winhttp.h)
WinHttpResetAutoProxy 関数は、自動プロキシをリセットします。
構文
WINHTTPAPI DWORD WinHttpResetAutoProxy(
[in] HINTERNET hSession,
[in] DWORD dwFlags
);
パラメーター
[in] hSession
WinHttpOpen 関数の以前の呼び出しによって返される有効な HINTERNET WinHTTP セッション ハンドル。
[in] dwFlags
リセット操作に影響するフラグのセット。
Winhttp.h ヘッダー ファイルで定義されているように、次のフラグがサポートされています。
| 値 | 説明 |
|---|---|
|
現在のネットワーク上の非永続的プロキシ情報を強制的にフラッシュして再試行します。 |
|
現在のネットワークの PAD 情報をフラッシュします。 |
|
すべてのネットワークの PAD 情報をフラッシュします。 |
|
プロキシ スクリプトの永続的な HTTP キャッシュをフラッシュします。 |
|
現在のネットワーク上のすべてのプロキシ情報を強制的にフラッシュして再試行します。 |
|
現在のプロキシ情報をフラッシュし、ネットワークが変更されたことを通知します。 |
|
現在のプロセスではなく、autoproxy サービスに対してアクションを実行します。 メモ このフラグは必須です。
WinHttpGetProxyForUrl 関数を使用してインプロセス キャッシュを消去するアプリケーションでは、hInternet ハンドルを閉じ、今後の呼び出しのために新しいハンドルを開く必要があります。 |
戻り値
操作の成功または失敗を示すコード。
| リターン コード | 説明 |
|---|---|
|
操作に成功しました。 |
|
hSession パラメーターは有効なハンドルではありません。 |
|
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 |