次の方法で共有

INTERNET_PER_CONN_OPTIONW構造体 (wininet.h)

  • [アーティクル]

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

構文

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPWSTR   pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONW, *LPINTERNET_PER_CONN_OPTIONW;

メンバーズ

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 Explorer 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 以降の :

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

Internet Explorer のバージョンに関係なく、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

符号なし long 整数値。

Value.pszValue

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

Value.ftValue

FILETIME 構造体。

備考

Internet Explorer 5 では、InternetQueryOption と InternetSetOption の ANSI バージョンのみが INTERNET_PER_CONN_OPTION 構造体で動作します。 Unicode バージョンでは、以降のバージョンの Internet Explorer で INTERNET_PER_CONN_OPTION 構造がサポートされます。

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

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

手記

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

必要条件

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

関連項目

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption

InternetSetOption