WinHttpSetDefaultProxyConfiguration

既定の WinHTTP プロキシ構成をレジストリに設定する。

WinHttpSetDefaultProxyConfiguration pProxyInfo

pProxyInfo : [var] 既定のプロキシ構成を指定する WINHTTP_PROXY_INFO 型の変数へのポインタ。

(プラグイン / モジュール : winhttp.dll)

解説

既定の WinHTTP プロキシ構成をレジストリに設定する。

[戻り値]
成功した場合は TRUE を、失敗した場合は FALSE を返す。拡張エラー情報は GetLastError
で取得する。返されるエラーコードには次のものがある。
（以下省略）

[備考]
**WinHttpSetDefaultProxyConfiguration**
で設定した既定のプロキシ構成は、WinHttpSetOption を呼び出し WINHTTP_OPTION_PROXY
フラグを指定することで、既存の WinHTTP セッションに対して上書きできる。新しいセッションに対する既定のプロキシ構成は
WinHttpOpen 関数で構成を指定することで上書きできる。プロキシを指定する場合、pProxyInfo が指す
WINHTTP_PROXY_INFO 構造体の *dwAccessType* メンバーを
WINHTTP_ACCESS_TYPE_NAMED_PROXY に設定する必要がある。そうでない場合は
WINHTTP_ACCESS_TYPE_DEFAULT_PROXY
に設定する。この関数の呼び出し後に作成された新しいセッションは、新しい既定のプロキシ構成を使う。WinHTTP が非同期モード
(WinHttpOpen で WINHTTP_FLAG_ASYNC が設定されている状態)
で使われる場合でも、この関数は同期的に動作する。戻り値は成功または失敗を示す。拡張エラー情報は GetLastError で取得する。注:
Windows XP および Windows 2000 については WinHTTP の開始ページの Run-Time
Requirements セクションを参照。

情報