WinHttpGetIEProxyConfigForCurrentUser 関数 (winhttp.h)

  • [アーティクル]

WinHttpGetIEProxyConfigForCurrentUser 関数は、現在のユーザーのインターネット エクスプローラー プロキシ構成を取得します。

構文

WINHTTPAPI BOOL WinHttpGetIEProxyConfigForCurrentUser(
  [in, out] WINHTTP_CURRENT_USER_IE_PROXY_CONFIG *pProxyConfig
);

パラメーター

[in, out] pProxyConfig

入力時に、 WINHTTP_CURRENT_USER_IE_PROXY_CONFIG 構造体へのポインター。 出力時に、構造体には、現在アクティブなネットワーク接続 (LAN、ダイヤルアップ、VPN 接続など) のインターネット エクスプローラー プロキシ設定が含まれます。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 拡張エラー情報については、 GetLastError を呼び出します。 返されるエラー コードは次のとおりです。

エラー コード 説明
ERROR_FILE_NOT_FOUND
 インターネット エクスプローラー プロキシ設定が見つかりません。
ERROR_WINHTTP_INTERNAL_ERROR
 内部エラーが発生しました。
ERROR_NOT_ENOUGH_MEMORY
 要求された操作を完了するのに十分なメモリが使用できませんでした。 (Windows エラー コード)

解説

インターネット エクスプローラーでは、[ツール / ] [インターネット オプション] メニュー オプションの [接続] タブにプロキシ設定があります。 プロキシ設定は接続ごとに構成されます。つまり、LAN 接続のプロキシ設定は、ダイヤルアップ接続または VPN 接続のプロキシ設定とは別です。 WinHttpGetIEProxyConfigForCurrentUser は 、現在アクティブな接続のプロキシ設定を返します。

この関数は、Web プロキシ自動検出 (WPAD) プロトコルが実装されていないネットワーク環境で実行されているクライアント アプリケーションで役立ちます (つまり、プロキシの自動構成ファイルが使用できません)。 PAC ファイルを使用できない場合、 WinHttpGetProxyForUrl 関数は失敗します。 WinHttpGetIEProxyConfigForCurrentUser 関数は、インターネット エクスプローラーでユーザーのプロキシ構成を取得することで、実行可能なプロキシ構成を検出するためのフォールバック メカニズムとして使用できます。

この関数は、ログオンしているユーザーを偽装しないサービス プロセスでは使用しないでください。呼び出し元がログオンしているユーザーを偽装しない場合、WinHTTP は現在のサービス プロセス (ローカル サービスやネットワーク サービスなど) のインターネット エクスプローラー設定を取得しようとします。 これらのシステム アカウントに対してインターネット エクスプローラー設定が構成されていない場合、WinHttpGetIEProxyConfigForCurrentUser の呼び出しは失敗します。

呼び出し元は、null 以外の場合は、WINHTTP_CURRENT_USER_IE_PROXY_CONFIG構造体の lpszProxy、lpszProxyBypass、lpszAutoConfigUrl の各文字列を解放する必要があります。 文字列を解放するには、 GlobalFree を使用します。

要件

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

関連項目

WinHTTP バージョン