オプションフラグ (Wininet.h)

  • [アーティクル]

InternetQueryOption 関数と InternetSetOption 関数では、次のオプション フラグが使用されます。 すべての有効なオプション フラグには、INTERNET_FIRST_OPTION以上の値と 、INTERNET_LAST_OPTION 以下の値 があります。

INTERNET_OPTION_ALTER_IDENTITY

80

未実装

INTERNET_OPTION_ASYNC

30

実装されていません。

INTERNET_OPTION_ASYNC_ID

15

実装されていません。

INTERNET_OPTION_ASYNC_PRIORITY

16

実装されていません。

INTERNET_OPTION_BYPASS_EDITED_ENTRY

64

新しいコンテンツのネットワークをチェックし、新しいバージョンが見つかった場合は編集されたキャッシュ エントリを上書きするかどうかを決定するブール値を設定または取得します。 True に設定すると、ネットワークで新しいコンテンツがチェックされ、編集されたキャッシュ エントリが新しいバージョンで上書きされます。 既定値は False です。これは、ネットワークを確認せずに編集されたキャッシュ エントリを使用する必要があることを示します。 これは、 InternetQueryOption と InternetSetOption によって使用されます。 これは、Microsoft インターネット エクスプローラー 5 以降でのみ有効です。

INTERNET_OPTION_CACHE_STREAM_HANDLE

27

サポート対象から除外されました。

INTERNET_OPTION_CACHE_TIMESTAMPS

69

インターネット キャッシュに格納されているリソースから LastModified 時刻と Expires 時間を含む INTERNET_CACHE_TIMESTAMPS 構造体を取得します。 この値は InternetQueryOption によって使用されます。

INTERNET_OPTION_CALLBACK

1

このハンドルに対して定義されているコールバック関数のアドレスを設定または取得します。 このオプションは、すべての HINTERNET ハンドルで使用できます。 InternetQueryOption と InternetSetOption によって使用されます。

INTERNET_OPTION_CALLBACK_FILTER

54

実装されていません。

INTERNET_OPTION_CLIENT_CERT_CONTEXT

84

このフラグは InternetQueryOption ではサポートされていません。 lpBuffer パラメーターは、CERT_CONTEXT ポインターへのポインターではなく、CERT_CONTEXT構造体へのポインターである必要があります。 アプリケーションが ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDEDを受信した場合は、要求を再試行する前に InternetErrorDlg を呼び出すか 、InternetSetOption を 使用して証明書を指定する必要があります。 その後、CertDuplicateCertificateContext が呼び出され、渡された証明書コンテキストをアプリケーションで個別に解放できます。

INTERNET_OPTION_CODEPAGE

68

既定では、Unicode URL のホストまたは機関の部分は、IDN 仕様に従ってエンコードされます。 IDN が無効になっている場合に要求または接続ハンドルにこのオプションを設定すると、URL のホスト部分のコード ページ エンコード スキームが指定されます。 InternetSetOption の呼び出しの lpBuffer パラメーターには、目的の DBCS コード ページが含まれています。 lpBuffer でコード ページが指定されていない場合、WinINet は既定のシステム コード ページ (CP_ACP) を使用します。 注: IDN が無効でない場合、このオプションは無視されます。 IDN を無効にする方法の詳細については、「 INTERNET_OPTION_IDN オプション」を参照してください。

SP2 と Windows Server 2003 SP1 の Windows XP: このフラグはサポートされていません。

バージョン：インターネット エクスプローラー 7.0 が必要です。

INTERNET_OPTION_CODEPAGE_PATH

100

既定では、URL のパス部分は UTF8 エンコードです。 WinINet API は、上位ビット文字に対してエスケープ文字 (%) エンコードを実行します。 要求または接続ハンドルでこのオプションを設定すると、UTF8 エンコードが無効になり、特定のコード ページが設定されます。 InternetSetOption の呼び出しの lpBuffer パラメーターには、パスに必要な DBCS コード ページが含まれています。 lpBuffer でコード ページが指定されていない場合、WinINet は既定のCP_UTF8を使用します。

SP2 と Windows Server 2003 SP1 の Windows XP: このフラグはサポートされていません。

バージョン：インターネット エクスプローラー 7.0 が必要です。

INTERNET_OPTION_CODEPAGE_EXTRA

101

既定では、URL のパス部分は既定のシステム コード ページ (CP_ACP) です。 エスケープ文字 (%) 変換は、余分な部分では実行されません。 要求または接続ハンドルでこのオプションを設定すると、CP_ACPエンコードが無効になります。 InternetSetOption の呼び出しの lpBuffer パラメーターには、URL の余分な部分に必要な DBCS コード ページが含まれています。 lpBuffer でコード ページが指定されていない場合、WinINet は既定のシステム コード ページ (CP_ACP) を使用します。

SP2 と Windows Server 2003 SP1 の Windows XP: このフラグはサポートされていません。

バージョン：インターネット エクスプローラー 7.0 が必要です。

INTERNET_OPTION_COMPRESSED_CONTENT_LENGTH

147

WinInet がサーバーから提供された Content-Encoding を圧縮解除した要求の場合、応答本文のサーバーから報告された Content-Length を ULONGLONG として取得します。 Windows 10 バージョン 1507 以降でサポートされています。

INTERNET_OPTION_CONNECT_BACKOFF

4

実装されていません。

INTERNET_OPTION_CONNECT_RETRIES

3

WinINet がホストの解決と接続を試行する回数を含む符号なし long 整数値を設定または取得します。 IP アドレスごとに 1 回だけ試行されます。 たとえば、10 個の IP アドレスを持ち、INTERNET_OPTION_CONNECT_RETRIESが 7 に設定されているマルチホーム ホストに接続しようとすると、WinINet は最初の 7 つの IP アドレスの解決と接続のみを試みます。 逆に、10 個の IP アドレスの同じセットを指定すると、INTERNET_OPTION_CONNECT_RETRIESが 20 に設定されている場合、WinINet は 10 個の各 IP アドレスを 1 回だけ試行します。 ホストが 1 つの IP アドレスがしか含まず、最初の接続試行が失敗した場合は、それ以上試行されません。 指定された回数試行した後も接続試行が失敗した場合、要求は取り消されます。 INTERNET_OPTION_CONNECT_RETRIESの既定値は 5 回です。 このオプションは、NULL ハンドルを含む任意の HINTERNET ハンドルで使用できます。 InternetQueryOption と InternetSetOption によって使用されます。

INTERNET_OPTION_CONNECT_TIME

55

実装されていません。

INTERNET_OPTION_CONNECT_TIMEOUT

2

インターネット接続要求に使用するタイムアウト値 (ミリ秒単位) を含む符号なし long 整数値を設定または取得します。 このオプションを無限 (0xFFFFFFFF) に設定すると、このタイマーが無効になります。

接続要求にこのタイムアウト値より長い時間がかかる場合、要求は取り消されます。 1 つのホスト (マルチホーム ホスト) の複数の IP アドレスに接続しようとすると、すべての IP アドレスに対してタイムアウト制限が累積されます。 このオプションは、NULL ハンドルを含む任意の HINTERNET ハンドルで使用できます。 InternetQueryOption と InternetSetOption によって使用されます。

INTERNET_OPTION_CONNECTED_STATE

50

接続状態を含む符号なし long 整数値を設定または取得します。 これは、 InternetQueryOption と InternetSetOption によって使用されます。

INTERNET_OPTION_CONTEXT_VALUE

45

この HINTERNET ハンドルに関連付けられているコンテキスト値のアドレスを含むDWORD_PTRを設定または取得します。 このオプションは、任意の HINTERNET ハンドルで使用できます。 これは、 InternetQueryOption と InternetSetOption によって使用されます。 以前は、コンテキスト値を lpBuffer ポインターに格納されているアドレスに設定しました。 これは、バッファーに格納されている値が使用され、 INTERNET_OPTION_CONTEXT_VALUE フラグに新しい値が割り当てられるように修正されました。 古い値 10 は、古い動作用に記述されたアプリケーションが引き続きサポートされるように保持されています。

INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT

6

INTERNET_OPTION_RECEIVE_TIMEOUTと同じです。 これは、 InternetQueryOption と InternetSetOption によって使用されます。

INTERNET_OPTION_CONTROL_SEND_TIMEOUT

5

INTERNET_OPTION_SEND_TIMEOUTと同じです。 これは、 InternetQueryOption と InternetSetOption によって使用されます。

INTERNET_OPTION_DATA_RECEIVE_TIMEOUT

8

FTP トランザクションのデータ チャネルに対する要求に対する応答を受信するために、タイムアウト値を含む符号なし long 整数値をミリ秒単位で設定または取得します。 応答にこのタイムアウト値よりも長い時間がかかる場合、要求はキャンセルされます。 このオプションは、NULL ハンドルを含む任意の HINTERNET ハンドルで使用できます。 InternetQueryOption と InternetSetOption によって使用されます。

このフラグは HTTP 機能には影響しません。

INTERNET_OPTION_DATA_SEND_TIMEOUT

7

FTP トランザクションのデータ チャネルに対する要求を送信するタイムアウト値を含む、符号なし long 整数値 (ミリ秒単位) を設定または取得します。 送信にこのタイムアウト値より長い時間がかかる場合、送信は取り消されます。 このオプションは、NULL ハンドルを含む任意の HINTERNET ハンドルで使用できます。 InternetQueryOption と InternetSetOption によって使用されます。

このフラグは HTTP 機能には影響しません。

INTERNET_OPTION_DATAFILE_NAME

33

ダウンロードしたエンティティをバックアップするファイルの名前を含む文字列値を取得します。 このフラグは、 InternetOpenUrl、 FtpOpenFile、 GopherOpenFile、または HttpOpenRequest が完了した後に有効です。 このオプションのクエリは、 InternetQueryOption でのみ実行できます。

INTERNET_OPTION_DATAFILE_EXT

96

ダウンロードしたエンティティをバックアップするファイルの拡張子を含む文字列値を設定します。 このフラグは、InternetOpenUrl、FtpOpenFile、GopherOpenFile、または HttpOpenRequest を呼び出す前に設定する必要があります。 このオプションは InternetSetOption でのみ設定できます。

INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO

67

指定した HTTP 要求に関するデータを含む INTERNET_DIAGNOSTIC_SOCKET_INFO 構造体を取得します。 このフラグは InternetQueryOption によって使用されます。

Windows 7: このオプションはサポートされなくなりました。

INTERNET_OPTION_DIGEST_AUTH_UNLOAD

76

システムがダイジェスト認証 SSPI パッケージからログオフし、プロセス用に作成されたすべての資格情報を消去します。 このオプションにはバッファーは必要ありません。 InternetSetOption によって使用されます。

INTERNET_OPTION_DISABLE_AUTODIAL

70

実装されていません。

INTERNET_OPTION_DISCONNECTED_TIMEOUT

49

実装されていません。

INTERNET_OPTION_ENABLE_HTTP_PROTOCOL

148

許容される高度な HTTP バージョンの DWORD ビットマスクを設定します。 任意のハンドルの種類に設定できます。 次のいずれかの値になります。

  • HTTP_PROTOCOL_FLAG_HTTP2 (0x2)。 Windows 10 バージョン 1507 以降でサポートされます。

従来のバージョンの HTTP (1.1 以前) は、このオプションを使用して無効にすることはできません。 既定値は 0x0 です。 Windows 10 バージョン 1507 以降でサポートされています。

INTERNET_OPTION_ENABLE_REDIRECT_CACHE_READ

122

要求ハンドルで、特定の要求の WinInet キャッシュからリダイレクトを返すかどうかを制御するブール値を設定します。 既定値は FALSE です。 Windows 8 以降でサポートされます。

INTERNET_OPTION_ENCODE_EXTRA

155

クエリ文字列の ASCII 以外の文字をパーセントエンコードする必要があるかどうかを示す BOOL を取得または設定します。 既定値は FALSE です。 Windows 8.1 以降でサポートされます。

INTERNET_OPTION_END_BROWSER_SESSION

42

使用されていないエントリをハード ディスク ドライブのパスワード キャッシュからフラッシュします。 同期モードがセッションごとに 1 回の場合に使用されるキャッシュ時間もリセットします。 このオプションにはバッファーは必要ありません。 これは InternetSetOption によって使用されます。

INTERNET_OPTION_ERROR_MASK

62

クライアント アプリケーションで処理できるエラー マスクを含む符号なし long 整数値を設定します。 これには、次の値の組み合わせを指定できます。

INTERNET_ERROR_MASK_COMBINED_SEC_CERT

0x2

すべての証明書エラーが、同じエラーの戻り値 ( つまりERROR_INTERNET_SEC_CERT_ERRORS) を使用して報告されることを示します。 このフラグが設定されている場合は、ERROR_INTERNET_SEC_CERT_ERRORSエラーを受信したときに InternetErrorDlg を呼び出して、ユーザーが問題を説明する使い慣れたダイアログに応答できるようにします。

注意事項

このエラーをユーザーに通知しないと、スプーフィング攻撃の可能性がユーザーに公開されます。

INTERNET_ERROR_MASK_INSERT_CDROM

0x1

クライアント アプリケーションが ERROR_INTERNET_INSERT_CDROM エラー コードを処理できることを示します。

INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY

0x8

クライアント アプリケーションが ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY エラー コードを処理できることを示します。

INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG

0x4

実装されていません。

INTERNET_OPTION_ENTERPRISE_CONTEXT

159

要求に適用されるエンタープライズ ID (参照 https://msdn.microsoft.com/library/windows/desktop/mt759320(v=vs.85).aspx) を含む PWSTR を設定します。 Windows 10 バージョン 1507 以降でサポートされます。

INTERNET_OPTION_EXTENDED_ERROR

24

このスレッド コンテキストで最後に返された ERROR_INTERNET_ エラー メッセージにマップされた Winsock エラー コードを含む符号なし長整数を取得します。 このオプションは、InternetQueryOption によって NULLHINTERNET ハンドルで使用されます。

INTERNET_OPTION_FROM_CACHE_TIMEOUT

63

リソースのコピーをキャッシュで確認する前に、システムがネットワーク要求への応答を待機する必要がある時間を含む、a1n 符号なし長整数を設定または取得します。 ネットワーク要求に指定された時間より長い時間がかかり、要求されたリソースがキャッシュで使用可能な場合、リソースはキャッシュから取得されます。 これは、 InternetQueryOption と InternetSetOption で使用されます。

INTERNET_OPTION_HANDLE_TYPE

9

渡された HINTERNET ハンドルの型を含む符号なし long 整数値を取得します。 これは、任意の HINTERNET ハンドルの InternetQueryOption によって使用されます。 可能な戻り値は次のとおりです。

INTERNET_HANDLE_TYPE_CONNECT_FTP

2

INTERNET_HANDLE_TYPE_CONNECT_GOPHER

3

INTERNET_HANDLE_TYPE_CONNECT_HTTP

4

INTERNET_HANDLE_TYPE_FILE_REQUEST

14

INTERNET_HANDLE_TYPE_FTP_FILE

7

INTERNET_HANDLE_TYPE_FTP_FILE_HTML

8

INTERNET_HANDLE_TYPE_FTP_FIND

5

INTERNET_HANDLE_TYPE_FTP_FIND_HTML

6

INTERNET_HANDLE_TYPE_GOPHER_FILE

11

INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML

12

INTERNET_HANDLE_TYPE_GOPHER_FIND

9

INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML

10

INTERNET_HANDLE_TYPE_HTTP_REQUEST

13

INTERNET_HANDLE_TYPE_INTERNET

1

INTERNET_OPTION_HSTS

157

WinInet がサーバーからの HTTP Strict Transport Security (HSTS) ディレクティブに従う必要があるかどうかを示す BOOL を取得または設定します。 有効にすると、WinInet によってキャッシュされた HSTS ポリシーを持つドメインに対する https:// スキームされた要求は、一致する https:// URL にリダイレクトされます。 既定値は FALSE です。 Windows 8.1 以降でサポートされます。

INTERNET_OPTION_HTTP_DECODING

65

WinINet が gzip のデコードを実行し、エンコード スキームをデフレートできるようにします。 詳細については、「 コンテンツ エンコード」を参照してください。

INTERNET_OPTION_HTTP_PROTOCOL_USED

149

特定の要求で使用された高度な HTTP バージョンを示す DWORD を取得します。 次のいずれかの値になります。

  • HTTP_PROTOCOL_FLAG_HTTP2 (0x2)。 Windows 10 バージョン 1507 以降でサポートされています。

0x0は HTTP/1.1 以前を示します。どのレガシ バージョンが使用されたかについて、より精度が必要な場合は、INTERNET_OPTION_HTTP_VERSIONを参照してください。 Windows 10 バージョン 1507 以降でサポートされています。

INTERNET_OPTION_HTTP_VERSION

59

サポートされている HTTP バージョンを含む HTTP_VERSION_INFO 構造体を設定または取得します。 これは NULL ハンドルで使用する必要があります。 これは、 InternetQueryOption と InternetSetOption で使用されます。

Windows 7、Windows Server 2008 R2 以降では、HTTP_VERSION_INFO構造体の dwMinorVersion メンバーの値は、インターネット エクスプローラー設定によってオーバーライドされます。 EnableHttp1_1は、システムのインターネット エクスプローラーで設定されたインターネット オプションによって制御される HKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE の下のレジストリ値です。 EnableHttp1_1値の既定値は 1 です。 EnableHttp1_1が 1 に設定されている場合、1.1 未満の HTTP バージョンでは、HTTP_VERSION_INFO構造体は無視されます。

INTERNET_OPTION_IDENTITY

78

実装されていません。

INTERNET_OPTION_IDLE_STATE

51

実装されていません。

INTERNET_OPTION_IDN

102

既定では、URL のホストまたは機関の部分は、直接接続とプロキシ接続の両方の IDN 仕様に従ってエンコードされます。 このオプションは、IDN を有効または無効にするために、要求または接続ハンドルで使用できます。 IDN が無効になっている場合、WinINet はシステム コード ページを使用して URL のホストまたは機関の部分をエンコードします。 IDN ホスト変換を無効にするには、InternetSetOption の呼び出しで lpBuffer パラメーターを 0 に設定します。 直接接続でのみ IDN 変換を有効にするには、InternetSetOption の呼び出しで lpBuffer パラメーターにINTERNET_FLAG_IDN_DIRECTを指定します。 プロキシ接続でのみ IDN 変換を有効にするには、InternetSetOption の呼び出しで lpBuffer パラメーターに INTERNET_FLAG_IDN_PROXY を指定します。

SP2 と Windows Server 2003 SP1 の Windows XP: このフラグはサポートされていません。

バージョン：インターネット エクスプローラー 7.0 が必要です。

INTERNET_OPTION_IGNORE_OFFLINE

77

指定した要求ハンドルに対してグローバル オフライン フラグを無視するかどうかを設定または取得します。 このオプションにはバッファーは必要ありません。 これは、要求ハンドルと 共に InternetQueryOption と InternetSetOption によって使用されます。 このオプションは、インターネット エクスプローラー 5 以降でのみ有効です。

INTERNET_OPTION_KEEP_CONNECTION

22

実装されていません。

INTERNET_OPTION_LISTEN_TIMEOUT

11

実装されていません。

INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER

74

HTTP/1.0 サーバーごとに許可される接続の最大数を含む符号なし long 整数値を設定または取得します。 これは、 InternetQueryOption と InternetSetOption で使用されます。 このオプションは、インターネット エクスプローラー 5 以降でのみ有効です。

INTERNET_OPTION_MAX_CONNS_PER_PROXY

103

CERN プロキシごとに許可される接続の最大数を含む符号なし long 整数値を設定または取得します。 このオプションを設定または取得する場合、 hInternet パラメーターは null ハンドル値に設定する必要があります。 null ハンドル値は、現在のプロセスに対してオプションを設定または照会する必要があることを示します。 このオプションを指定して InternetSetOption を 呼び出すと、既存のすべてのプロキシ オブジェクトが新しい値を受け取ります。 この値は、2 ~ 128 の範囲に制限されています。

バージョン：インターネット エクスプローラー 8.0 が必要です。

INTERNET_OPTION_MAX_CONNS_PER_SERVER

73

サーバーごとに許可される接続の最大数を含む符号なし long 整数値を設定または取得します。 これは、 InternetQueryOption と InternetSetOption で使用されます。 このオプションは、インターネット エクスプローラー 5 以降でのみ有効です。

INTERNET_OPTION_OFFLINE_MODE

26

実装されていません。

INTERNET_OPTION_OFFLINE_SEMANTICS

52

実装されていません。

INTERNET_OPTION_OPT_IN_WEAK_SIGNATURE

176

脆弱な署名 (SHA-1 など) を安全でないものとして扱うオプトイン。 これにより、CERT_CHAIN_OPT_IN_WEAK_SIGNATURE パラメーターを使用して CertGetCertificateChain を呼び出すように WinInet に指示されます。

INTERNET_OPTION_PARENT_HANDLE

21

このハンドルの親ハンドルを取得します。 このオプションは、InternetQueryOption によって任意の HINTERNET ハンドルで使用できます。

INTERNET_OPTION_PASSWORD

29

InternetConnect によって返されるハンドルに関連付けられているパスワードを含む文字列値を設定または取得します。 これは、 InternetQueryOption と InternetSetOption で使用されます。

INTERNET_OPTION_PER_CONNECTION_OPTION

75

特定の接続のオプションの一覧を指定する INTERNET_PER_CONN_OPTION_LIST 構造体を設定または取得します。 これは、 InternetQueryOption と InternetSetOption で使用されます。 このオプションは、インターネット エクスプローラー 5 以降でのみ有効です。

Note

INTERNET_OPTION_PER_CONNECTION_OPTION、InternetSetOption の呼び出しで NULL ハンドルを使用すると、システム全体で設定が変更されます。 グローバル プロキシ設定を更新するには、INTERNET_OPTION_REFRESH オプション フラグを指定して InternetSetOption を呼び出す必要があります。

Note

インターネット エクスプローラー 5 以降のグローバル設定に影響を与えずにプロセス全体のプロキシ情報を変更するには、InternetOpen から返されるハンドルでこのオプションを使用します。 次のコード例では、 HINTERNET ハンドルが閉じられ、どの要求でも使用されていない場合でも、プロセス全体のプロキシを変更します。

INTERNET_OPTION_POLICY

48

実装されていません。

INTERNET_OPTION_PROXY

38

HINTERNET ハンドルが NULL でない場合に、既存の InternetOpen ハンドルのプロキシ データを含むINTERNET_PROXY_INFO構造体を設定または取得します。 HINTERNET ハンドルが NULL の場合、関数はグローバル プロキシ データを設定または照会します。 このオプションは、 InternetOpen によって返されるハンドルで使用できます。 これは、InternetQueryOption と InternetSetOption によって使用されます。

Note

INTERNET_OPTION_PROXYの代わりにINTERNET_OPTION_PER_CONNECTION_OPTION使用することをお勧めします。

INTERNET_OPTION_PROXY_PASSWORD

44

プロキシへのアクセスに使用するパスワードを含む文字列値を設定または取得します。 これは、 InternetQueryOption と InternetSetOption で使用されます。 このオプションは、 InternetConnect または HttpOpenRequest によって返されるハンドルで設定できます。

INTERNET_OPTION_PROXY_SETTINGS_CHANGED

95

プロキシ設定が変更され、新しい設定で更新する必要があることを現在の WinInet インスタンスに通知します。 使用可能なすべての WinInet インスタンスに警告するには、このオプションを渡すときに InternetSetOption の Buffer パラメーターを NULL に、BufferLength を 0 に設定します。 このオプションは、 InternetConnect または HttpOpenRequest によって返されるハンドルで設定できます。

INTERNET_OPTION_PROXY_USERNAME

43

プロキシへのアクセスに使用するユーザー名を含む文字列値を設定または取得します。 これは、 InternetQueryOption と InternetSetOption で使用されます。 このオプションは、 InternetConnect または HttpOpenRequest によって返されるハンドルで設定できます。

INTERNET_OPTION_READ_BUFFER_SIZE

12

読み取りバッファーのサイズを含む符号なし長整数を設定または取得します。 このオプションは、FtpOpenFile、FtpFindFirstFile、および InternetConnect (FTP セッションのみ) によって返される HINTERNET ハンドルで使用できます。 このオプションは、 InternetQueryOption と InternetSetOption で使用されます。

INTERNET_OPTION_RECEIVE_THROUGHPUT

57

実装されていません。

INTERNET_OPTION_RECEIVE_TIMEOUT

6

要求に対する応答を受信するタイムアウト値を含む符号なし長整数をミリ秒単位で設定または取得します。 応答にこのタイムアウト値よりも長い時間がかかる場合、要求はキャンセルされます。 このオプションは、NULL ハンドルを含む任意の HINTERNET ハンドルで使用できます。 これは、InternetQueryOption と InternetSetOption によって使用されます。

このオプションは、きめ細かい即時タイムアウトを表すものではありません。 タイムアウトは、設定されたタイムアウト値から最大 6 秒後に発生することが予想されます。

FTP トランザクションへの参照で使用する場合、このオプションは制御チャネルを参照します。

INTERNET_OPTION_REFRESH

37

ハンドルのレジストリからプロキシ データを再読み取りします。 バッファーは必要ありません。 このオプションは、InternetOpen によって返される HINTERNET ハンドルで使用できます。 これは InternetSetOption によって使用されます。

INTERNET_OPTION_REMOVE_IDENTITY

79

実装されていません。

INTERNET_OPTION_REQUEST_FLAGS

23

ダウンロードの進行中の状態を示す特殊な状態フラグを含む符号なし長整数を取得します。 これは InternetQueryOption で使用されます。 INTERNET_OPTION_REQUEST_FLAGS オプションには、次のいずれかの値を指定できます。

INTERNET_REQFLAG_ASYNC

0x00000002

実装されていません。

INTERNET_REQFLAG_CACHE_WRITE_DISABLED

0x00000040

インターネット要求をキャッシュできません (HTTPS 要求など)。

INTERNET_REQFLAG_FROM_CACHE

0x00000001

応答はキャッシュから送信されました。

INTERNET_REQFLAG_NET_TIMEOUT

0x00000080

インターネット要求がタイムアウトしました。

INTERNET_REQFLAG_NO_HEADERS

0x00000008

元の応答にヘッダーが含まれていません。

INTERNET_REQFLAG_PASSIVE

0x00000010

実装されていません。

INTERNET_REQFLAG_VIA_PROXY

0x00000004

要求はプロキシを介して行われました。

INTERNET_OPTION_REQUEST_PRIORITY

58

HTTP ハンドル上の接続に対して競合する要求の優先順位を含む符号なし長整数を設定または取得します。 これは、 InternetQueryOption と InternetSetOption で使用されます。

INTERNET_OPTION_RESET_URLCACHE_SESSION

60

プロセスの新しいキャッシュ セッションを開始します。 バッファーは必要ありません。 これは InternetSetOption によって使用されます。 このオプションは、内部使用専用に予約されています。

INTERNET_OPTION_SECONDARY_CACHE_KEY

53

セカンダリ キャッシュ キーを含む文字列値を設定または取得します。 これは、 InternetQueryOption と InternetSetOption で使用されます。 このオプションは、内部使用専用に予約されています。

INTERNET_OPTION_SECURITY_CERTIFICATE

35

SSL/PCT (Secure Sockets Layer/Private Communications Technology) サーバーの証明書を書式設定された文字列に取得します。 これは InternetQueryOption で使用されます。

INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT

32

SSL/PCT サーバーの証明書をINTERNET_CERTIFICATE_INFO構造に取得します。 これは InternetQueryOption で使用されます。

INTERNET_OPTION_SECURITY_FLAGS

31

ハンドルのセキュリティ フラグを含む符号なし長整数を取得します。 このオプションは、 InternetQueryOption によって使用されます。 次の値を組み合わせて使用できます。

SECURITY_FLAG_128BIT

0x20000000

優先値 SECURITY_FLAG_STRENGTH_STRONGと同じです。 これは、 InternetQueryOption の呼び出しでのみ返されます。

SECURITY_FLAG_40BIT

0x10000000

優先値 SECURITY_FLAG_STRENGTH_WEAKと同じです。 これは、 InternetQueryOption の呼び出しでのみ返されます。

SECURITY_FLAG_56BIT

0x40000000

優先値 SECURITY_FLAG_STRENGTH_MEDIUMと同じです。 これは、 InternetQueryOption の呼び出しでのみ返されます。

SECURITY_FLAG_FORTEZZA

0x08000000

Fortezza が、指定された接続の秘密、認証、および/または整合性を提供するために使用されたことを示します。

SECURITY_FLAG_IETFSSL4

0x00000020

実装されていません。

SECURITY_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

ERROR_INTERNET_SEC_CERT_CN_INVALIDエラー メッセージ を 無視します。

SECURITY_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

ERROR_INTERNET_SEC_CERT_DATE_INVALIDエラー メッセージ を 無視します。

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIRエラー メッセージを無視します。

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIRエラー メッセージ を 無視します。

SECURITY_FLAG_IGNORE_REVOCATION

0x00000080

証明書失効の問題を無視します。

SECURITY_FLAG_IGNORE_UNKNOWN_CA

0x00000100

不明な証明機関の問題を無視します。

SECURITY_FLAG_IGNORE_WEAK_SIGNATURE

0x00010000

脆弱な証明書署名の問題を無視します。

SECURITY_FLAG_IGNORE_WRONG_USAGE

0x00000200

不適切な使用の問題を無視します。

SECURITY_FLAG_NORMALBITNESS

0x10000000

SECURITY_FLAG_STRENGTH_WEAK値と同じです。 これは、 InternetQueryOption の呼び出しでのみ返されます。

SECURITY_FLAG_PCT

0x00000008

実装されていません。

SECURITY_FLAG_PCT4

0x00000010

実装されていません。

SECURITY_FLAG_SECURE

0x00000001

セキュリティで保護された転送を使用します。 これは、 InternetQueryOption の呼び出しでのみ返されます。

SECURITY_FLAG_SSL

0x00000002

実装されていません。

SECURITY_FLAG_SSL3

0x00000004

実装されていません。

SECURITY_FLAG_STRENGTH_MEDIUM

0x40000000

中 (56 ビット) 暗号化を使用します。 これは、 InternetQueryOption の呼び出しでのみ返されます。

SECURITY_FLAG_STRENGTH_STRONG

0x20000000

強力な (128 ビット) 暗号化を使用します。 これは、 InternetQueryOption の呼び出しでのみ返されます。

SECURITY_FLAG_STRENGTH_WEAK

0x10000000

弱い (40 ビット) 暗号化を使用します。 これは、 InternetQueryOption の呼び出しでのみ返されます。

SECURITY_FLAG_UNKNOWNBIT

0x80000000

暗号化で使用されるビット サイズが不明です。 これは、 InternetQueryOption の呼び出しでのみ返されます。

この方法で取得されたデータは、セキュリティ レベルを変更できなくなった、発生したトランザクションに関連していることに注意してください。

INTERNET_OPTION_SECURITY_KEY_BITNESS

36

暗号化キーのビット サイズを含む符号なし長整数を取得します。 数値が大きいほど、使用される暗号化強度が高くなります。 これは InternetQueryOption で使用されます。 この方法で取得されたデータは、セキュリティ レベルを変更できなくなった、既に発生しているトランザクションに関連していることに注意してください。

INTERNET_OPTION_SEND_THROUGHPUT

56

実装されていません。

INTERNET_OPTION_SEND_TIMEOUT

5

要求を送信するタイムアウト値を含む符号なし長整数 (ミリ秒単位) を設定または取得します。 送信にこのタイムアウト値より長い時間がかかる場合、送信は取り消されます。 このオプションは、NULL ハンドルを含む任意の HINTERNET ハンドルで使用できます。 これは、InternetQueryOption と InternetSetOption によって使用されます。

FTP トランザクションへの参照で使用する場合、このオプションは制御チャネルを参照します。

INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT

105

サーバーの証明書チェーン コンテキストを重複する PCCERT_CHAIN_CONTEXTとして取得します。 この重複したコンテキストを、 PCCERT_CHAIN_CONTEXTを受け取る任意の Crypto API 関数に渡すことができます。 証明書チェーン コンテキストが完了したら、返されたPCCERT_CHAIN_CONTEXTで CertFreeCertificateChain を呼び出す必要があります。

バージョン：インターネット エクスプローラー 8.0 が必要です。

INTERNET_OPTION_SETTINGS_CHANGED

39

レジストリ設定が変更されたことをシステムに通知して、 InternetConnect の次回の呼び出しで設定を検証します。 これは InternetSetOption によって使用されます。

INTERNET_OPTION_SUPPRESS_SERVER_AUTH

104

配信元サーバーにログオンせず、HTTP プロキシ サーバーへの自動ログオンを実行するように HTTP 要求オブジェクトを設定します。 このオプションは、要求フラグ INTERNET_FLAG_NO_AUTHとは異なり、プロキシ サーバーと配信元サーバーの両方に対する認証が禁止されます。

このモードを設定すると、配信元サーバーと通信するときに、資格情報マテリアル (以前に指定したユーザー名/パスワードまたはクライアント SSL 証明書) の使用が抑制されます。 ただし、要求を認証プロキシ経由で転送する必要がある場合でも、WinINet はユーザーのイントラネット ゾーン設定に従って HTTP プロキシへの自動認証を実行します。 既定のイントラネット ゾーン設定では、ユーザーの既定の資格情報を使用して自動ログオンを許可します。

すべての識別情報を抑制するには、呼び出し元が INTERNET_OPTION_SUPPRESS_SERVER_AUTH を INTERNET_FLAG_NO_COOKIES 要求フラグと組み合わせる必要があります。

このオプションは、要求オブジェクトが送信される前にのみ設定できます。 要求の送信後にこのオプションを設定しようとすると、 ERROR_INTERNET_INCORRECT_HANDLE_STATEが返されます。

このオプションにはバッファーは必要ありません。 これは、HttpOpenRequest によって返されるハンドルでのみ InternetSetOption によって使用されます。

バージョン：インターネット エクスプローラー 8.0 以降が必要です。

INTERNET_OPTION_SUPPRESS_BEHAVIOR

81

プロセス全体で動作を抑制するために使用される汎用オプション。 関数の lpBuffer パラメーターは、抑制する特定の動作を含む DWORD へのポインターである必要があります。 このオプションは、 InternetQueryOption では照会できません。 許可される値は次のとおりです。

INTERNET_SUPPRESS_RESET_ALL

0

すべての抑制を無効にし、既定の動作と構成済みの動作を再度有効にします。 このオプションは、 INTERNET_SUPPRESS_COOKIE_POLICY_RESET と INTERNET_SUPPRESS_COOKIE_PERSIST_RESET を個別に設定することと同じです。

バージョン：インターネット エクスプローラー 6.0 以降が必要です。

INTERNET_SUPPRESS_COOKIE_POLICY

1

構成された Cookie ポリシーを無視し、Cookie の設定を許可します。

バージョン：インターネット エクスプローラー 6.0 以降が必要です。

INTERNET_SUPPRESS_COOKIE_POLICY_RESET

2

INTERNET_SUPPRESS_COOKIE_POLICY抑制を無効にし、構成された Cookie ポリシーに従って Cookie の評価を許可します。

バージョン：インターネット エクスプローラー 6.0 以降が必要です。

INTERNET_SUPPRESS_COOKIE_PERSIST

3

サーバーで永続的として指定されている場合でも、Cookie の永続化を抑制します。

バージョン：インターネット エクスプローラー 8.0 以降が必要です。

INTERNET_SUPPRESS_COOKIE_PERSIST_RESET

4

cookie の永続化を再度有効にして、 INTERNET_SUPPRESS_COOKIE_PERSIST 抑制を無効にします。 以前に抑制された Cookie は永続的になりません。

バージョン：インターネット エクスプローラー 8.0 以降が必要です。

INTERNET_OPTION_URL

34

ダウンロードしたリソースの完全な URL を含む文字列値を取得します。 検索文字列やアンカーなどの追加データが元の URL に含まれている場合、または呼び出しがリダイレクトされた場合、返される URL は元の URL とは異なります。 このオプションは、InternetOpenUrl、FtpOpenFile、GopherOpenFile、または HttpOpenRequest によって返される HINTERNET ハンドルで有効です。 InternetQueryOption によって使用されます。

INTERNET_OPTION_USER_AGENT

41

HttpAddRequestHeaders または HttpSendRequest によって追加されたヘッダーによってオーバーライドされない限り、InternetOpen によって提供され、後続の HttpSendRequest 関数で使用されるハンドルに対してユーザー エージェント文字列を設定または取得します。 これは、 InternetQueryOption と InternetSetOption で使用されます。

INTERNET_OPTION_USERNAME

28

InternetConnect によって返されるハンドルに関連付けられているユーザー名を含む文字列を設定または取得します。 これは、 InternetQueryOption と InternetSetOption で使用されます。

INTERNET_OPTION_VERSION

40

Wininet.dllのバージョン番号を含むINTERNET_VERSION_INFO構造体を取得します。 このオプションは、InternetQueryOption によって NULLHINTERNET ハンドルで使用できます。

INTERNET_OPTION_WRITE_BUFFER_SIZE

13

書き込みバッファーのサイズ (バイト単位) を含む符号なし長整数を設定または取得します。 このオプションは、FtpOpenFile および InternetConnect によって返される HINTERNET ハンドルで使用できます (FTP セッションのみ)。 これは、InternetQueryOption と InternetSetOption によって使用されます。

解説

Note

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

要件

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