INTERNET_PER_CONN_OPTIONA構造体 (wininet.h)
オプションの値を格納します。
構文
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
-
接続によって設定が自動的に検出されます。
|
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.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてINTERNET_PER_CONN_OPTIONを定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 |
値 |
サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
Header |
wininet.h |
こちらもご覧ください
INTERNET_PER_CONN_OPTION_LIST
InternetQueryOption
InternetSetOption