INTERNET_PER_CONN_OPTIONA構造体 (wininet.h)

[アーティクル]
08/27/2023

オプションの値を格納します。

構文

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPSTR    pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONA, *LPINTERNET_PER_CONN_OPTIONA;

メンバー

dwOption

クエリまたは設定するオプション。このメンバーには、次のいずれかの値を指定できます。

値	意味
INTERNET_PER_CONN_AUTOCONFIG_URL	自動構成スクリプトの URL を含む文字列を設定または取得します。
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS	自動検出設定を設定または取得します。 Value メンバーには、次の 1 つ以上の値が含まれます。 AUTO_PROXY_FLAG_ALWAYS_DETECT 設定は常に自動的に検出されます。 AUTO_PROXY_FLAG_CACHE_INIT_RUN キャッシュされたファイルの有効期限が切れていない限り、スクリプトを実際に実行するのではなく、自動プロキシ構成スクリプトのキャッシュされた結果を使用する必要があることを示します。 AUTO_PROXY_FLAG_DETECTION_RUN 自動検出は、この接続で少なくとも 1 回実行されています。 AUTO_PROXY_FLAG_DETECTION_SUSPECT 現在はサポートされていません。 AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT 自動プロキシ構成スクリプトの結果のキャッシュを許可しないでください。 AUTO_PROXY_FLAG_MIGRATED この設定は Microsoft Internet エクスプローラー 4.0 インストールから移行されました。自動検出は 1 回試行する必要があります。 AUTO_PROXY_FLAG_USER_SET ユーザーが自動検出を明示的に設定しました。
INTERNET_PER_CONN_FLAGS	接続の種類を設定または取得します。 Value メンバーには、次の 1 つ以上の値が含まれます。 PROXY_TYPE_DIRECT 接続ではプロキシサーバーは使用されません。 PROXY_TYPE_PROXY 接続では、明示的に設定されたプロキシサーバーが使用されます。 PROXY_TYPE_AUTO_PROXY_URL 接続は、指定された URL で自動構成スクリプトをダウンロードして処理します。 PROXY_TYPE_AUTO_DETECT 接続によって設定が自動的に検出されます。
INTERNET_PER_CONN_PROXY_BYPASS	プロキシサーバーを使用しない URL を含む文字列を設定または取得します。
INTERNET_PER_CONN_PROXY_SERVER	プロキシサーバーを含む文字列を設定または取得します。
INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL	チェーンされた自動構成 URL。プライマリ自動構成 URL が、プロキシ情報の 2 番目の自動構成 URL を設定する INS ファイルを指している場合に使用されます。
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS	自動検出による自動構成 URL の自動更新までの時間 (分)。
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME	読み取り専用オプション。自動検出を使用して、最後に既知の正常な自動構成 URL が見つかった時刻を返します。
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL	読み取り専用オプション。自動検出を使用して検出された最後の既知の正常な URL を返します。

Windows 7 以降:

インターネットエクスプローラー 8 をサポートするクライアントは、INTERNET_PER_CONN_FLAGS_UIを使用して接続の種類を照会する必要があります。このクエリが失敗した場合、システムは以前のバージョンのインターネットエクスプローラーを実行しており、クライアントはINTERNET_PER_CONN_FLAGSを使用して再度クエリを実行する必要があります。

インターネットエクスプローラーのバージョンに関係なく、INTERNET_PER_CONN_FLAGSを使用して接続の種類を復元します。

値	意味
INTERNET_PER_CONN_FLAGS_UI	接続の種類を設定または取得します。 Value メンバーには、次の 1 つ以上の値が含まれます。 PROXY_TYPE_DIRECT 接続ではプロキシサーバーは使用されません。 PROXY_TYPE_PROXY 接続では、明示的に設定されたプロキシサーバーが使用されます。 PROXY_TYPE_AUTO_PROXY_URL 接続は、指定された URL で自動構成スクリプトをダウンロードして処理します。 PROXY_TYPE_AUTO_DETECT 接続によって設定が自動的に検出されます。

値

意味

INTERNET_PER_CONN_FLAGS_UI

接続の種類を設定または取得します。 Value メンバーには、次の 1 つ以上の値が含まれます。

PROXY_TYPE_DIRECT: 接続ではプロキシサーバーは使用されません。
PROXY_TYPE_PROXY: 接続では、明示的に設定されたプロキシサーバーが使用されます。
PROXY_TYPE_AUTO_PROXY_URL: 接続は、指定された URL で自動構成スクリプトをダウンロードして処理します。
PROXY_TYPE_AUTO_DETECT: 接続によって設定が自動的に検出されます。

Value

オプションの値を含む共用体。 dwOption の値に応じて、次のいずれかの型を指定できます。

dwValue

符号なし long 整数値。

pszValue

文字列値へのポインター。

ftValue

FILETIME 構造体。

Value.dwValue

Value.pszValue

Value.ftValue

注釈

Internet エクスプローラー 5 では、InternetQueryOption と InternetSetOption の ANSI バージョンのみがINTERNET_PER_CONN_OPTION構造体で動作します。 Unicode バージョンでは、新しいバージョンのインターネット エクスプローラーでINTERNET_PER_CONN_OPTION構造がサポートされます。

文字列を返すクエリの場合、 InternetQueryOption は構造体の pszValue メンバーにメモリを割り当てます。呼び出し元のアプリケーションは、文字列の使用が完了したら、 GlobalFree 関数を使用してこのメモリを解放する必要があります。

メモ WinINet では、サーバーの実装はサポートされていません。また、サービスから使用しないでください。サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。

注意

wininet.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてINTERNET_PER_CONN_OPTIONを定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

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