WINHTTP_AUTOPROXY_OPTIONS 構造体 (winhttp.h)

  • [アーティクル]

WINHTTP_AUTOPROXY_OPTIONS構造体は、プロキシ自動構成 (PAC) ファイルの URL を指定するか、ネットワークへの DHCP または DNS クエリを使用して URL を自動的に検索するかを WinHttpGetProxyForURL 関数に示すために使用されます。

構文

typedef struct _WINHTTP_AUTOPROXY_OPTIONS {
  DWORD   dwFlags;
  DWORD   dwAutoDetectFlags;
  LPCWSTR lpszAutoConfigUrl;
  LPVOID  lpvReserved;
  DWORD   dwReserved;
  BOOL    fAutoLogonIfChallenged;
} WINHTTP_AUTOPROXY_OPTIONS, *PWINHTTP_AUTOPROXY_OPTIONS;

メンバー

dwFlags

PAC ファイルを取得するには、メカニズムを使用する必要があります。

値 意味
WINHTTP_AUTOPROXY_ALLOW_AUTOCONFIG
 自動構成 URL を使用したプロキシ検出を有効にします。
 
メモこのフラグのサポートは、Windows 10 バージョン 1703 (10.0;ビルド 15063)。
 
WINHTTP_AUTOPROXY_ALLOW_CM
 接続マネージャーを介したプロキシ検出を有効にします。
 
メモこのフラグのサポートは、Windows 10 バージョン 1703 (10.0;ビルド 15063)。
 
WINHTTP_AUTOPROXY_ALLOW_STATIC
 静的構成を使用したプロキシ検出を有効にします。
 
メモこのフラグのサポートは、Windows 10 バージョン 1703 (10.0;ビルド 15063)。
 
WINHTTP_AUTOPROXY_AUTO_DETECT
 ローカル ネットワークへの DHCP クエリと DNS クエリの両方を使用して、PAC ファイルの URL を自動的に検出しようとします。
WINHTTP_AUTOPROXY_CONFIG_URL
 WINHTTP_AUTOPROXY_OPTIONS構造体の lpszAutoConfigUrl で指定された URL から PAC ファイルをダウンロードします。
WINHTTP_AUTOPROXY_HOST_KEEPCASE
 PAC スクリプトに渡されるホスト名の大文字と小文字を維持します。 これが既定の動作です。
WINHTTP_AUTOPROXY_HOST_LOWERCASE
 PAC スクリプトに渡す前に、ホスト名を小文字に変換します。
WINHTTP_AUTOPROXY_NO_CACHE_CLIENT
 スクリプト実行結果のプロキシ キャッシュに対するホストのクエリを現在のプロセスで無効にします。
WINHTTP_AUTOPROXY_NO_CACHE_SVC
 スクリプト実行結果のプロキシ キャッシュに対するホストのクエリを autoproxy サービスで無効にします。
WINHTTP_AUTOPROXY_NO_DIRECTACCESS
 この要求に対するダイレクト アクセス プロキシ設定のクエリを無効にします。
WINHTTP_AUTOPROXY_RUN_INPROCESS
 アウトプロセス WinHTTP AutoProxy Service (使用可能な場合) に委任するのではなく、Web プロキシ自動検出 (WPAD) プロトコルをインプロセスで実行します。 このフラグは、他のフラグのいずれかと組み合わせる必要があります。

WinHttpGetProxyForUrlEx に渡された場合、このオプションは無効です。

メモ このフラグは非推奨です。
 
WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY
 既定では、WinHTTP は、処理中のプロキシを自動検出するようにフォールバックするように構成されています。 アウトプロセス検出が失敗した場合にこのフォールバック動作が望ましくない場合は、このフラグを使用して無効にすることができます。

WinHttpGetProxyForUrlEx に渡された場合、このオプションは無効です。

メモ このフラグは、Windows Server 2003 でのみ使用できます。
 
WINHTTP_AUTOPROXY_SORT_RESULTS
最速のプロキシを最初に配置するヒューリスティックに基づいてプロキシの結果を並べ替えます。

dwAutoDetectFlags

dwFlags に WINHTTP_AUTOPROXY_AUTO_DETECT フラグが含まれている場合、dwAutoDetectFlags は PAC ファイルの検索に使用するプロトコルを指定します。 DHCP と DNS 自動検出フラグの両方が指定されている場合は、最初に DHCP が使用されます。DHCP を使用して PAC URL が検出されない場合は、DNS が使用されます。

dwFlags に WINHTTP_AUTOPROXY_AUTO_DETECT フラグが含まれていない場合、dwAutoDetectFlags は 0 である必要があります。

値 意味
WINHTTP_AUTO_DETECT_TYPE_DHCP
 DHCP を使用して、プロキシの自動構成ファイルを見つけます。
WINHTTP_AUTO_DETECT_TYPE_DNS_A
 DNS を使用して、ローカル コンピューターのドメイン上の既知の場所にプロキシの自動構成ファイルを検索します。

lpszAutoConfigUrl

dwFlags に WINHTTP_AUTOPROXY_CONFIG_URL フラグが含まれている場合、lpszAutoConfigUrl は、プロキシ自動構成 (PAC) ファイルの URL を含む null で終わる Unicode 文字列を指す必要があります。

dwFlags に WINHTTP_AUTOPROXY_CONFIG_URL フラグが含まれていない場合、lpszAutoConfigUrl はNULL である必要があります。

lpvReserved

将来の使用のために予約済み。 は NULL である必要があります。

dwReserved

今後使用するために予約されています。0 にする必要があります。

fAutoLogonIfChallenged

WinHTTP が PAC ファイルを要求したときに、NTLM またはネゴシエート認証チャレンジに応答して、クライアントのドメイン資格情報を自動的に送信するかどうかを指定します。

このフラグが TRUE の場合、認証チャレンジに応答して資格情報が自動的に送信されます。 このフラグが FALSE で、PAC ファイルをダウンロードするために認証が必要な場合、 WinHttpGetProxyForUrl 関数は失敗します。

要件

要件 値
サポートされている最小のクライアント Windows XP、Windows 2000 Professional SP3 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003、Windows 2000 Server SP3 [デスクトップ アプリのみ]
Header winhttp.h

こちらもご覧ください

WinHTTP バージョン