API フラグ

WinINet 関数の多くは、パラメーターとしてフラグの配列を受け入れます。 定義されているフラグの簡単な説明を次に示します。

INTERNET_COOKIE_EVALUATE_P3P

0x80

プライバシー保護プラットフォーム (P3P) ヘッダーが Cookie に関連付けられていることを示します。

INTERNET_COOKIE_THIRD_PARTY

0x10

サード パーティの Cookie が設定または取得されていることを示します。

INTERNET_FLAG_ASYNC

0x10000000

この関数から返されたハンドルから派生したハンドルに対して非同期要求のみを行います。 InternetOpen 関数のみがこのフラグを使用します。

INTERNET_FLAG_CACHE_ASYNC

0x00000080

遅延キャッシュ書き込みを許可します。

INTERNET_FLAG_CACHE_IF_NET_FAIL

0x00010000

ERROR_INTERNET_CONNECTION_RESETまたはERROR_INTERNET_CANNOT_CONNECT エラーが原因でリソースのネットワーク要求が失敗した場合は、キャッシュからリソースを返します。 このフラグは、 HttpOpenRequest によって使用されます。

INTERNET_FLAG_DONT_CACHE

0x04000000

返されたエンティティをキャッシュに追加しません。 これは、優先値 である INTERNET_FLAG_NO_CACHE_WRITE と同じです。

INTERNET_FLAG_EXISTING_CONNECT

0x20000000

要求を行うために必要な同じ属性を持つ InternetConnect オブジェクトが存在する場合、既存の InternetConnect オブジェクトの使用を試みます。 これは、通常、同じセッション中に複数の操作を実行する唯一のプロトコルである FTP であるため、FTP 操作でのみ役立ちます。 WinINet は、InternetOpen によって生成された HINTERNET ハンドルごとに 1 つの接続ハンドルをキャッシュします。 InternetOpenUrl 関数と InternetConnect 関数は、Http 接続と Ftp 接続にこのフラグを使用します。

INTERNET_FLAG_FORMS_SUBMIT

0x00000040

これがフォーム送信であることを示します。

INTERNET_FLAG_FROM_CACHE

0x01000000

ネットワーク要求を行いません。 すべてのエンティティがキャッシュから返されます。 要求された項目がキャッシュにない場合は、ERROR_FILE_NOT_FOUNDなどの適切なエラーが返されます。 InternetOpen 関数のみがこのフラグを使用します。

INTERNET_FLAG_FWD_BACK

0x00000020

関数が、現在インターネット キャッシュ内にあるリソースのコピーを使用する必要があることを示します。 有効期限とリソースに関するその他の情報はチェックされません。 要求された項目がインターネット キャッシュに見つからない場合、システムはネットワーク上のリソースの検索を試みます。 この値は Microsoft Internet エクスプローラー 5 で導入され、インターネット エクスプローラーの [転送] ボタンと [戻る] ボタンの操作に関連付けられています。

INTERNET_FLAG_HYPERLINK

0x00000400

ネットワークからアイテムを再読み込みするかどうかを決定するときに、有効期限時間がなく、サーバーから LastModified 時刻が返されない場合は、強制的に再読み込みを行います。 このフラグは、 FtpFindFirstFile、 FtpGetFile、 FtpOpenFile、 FtpPutFile、 HttpOpenRequest、 InternetOpenUrl で使用できます。

Windows XP および Windows Server 2003 R2 以前:GopherFindFirstFile および GopherOpenFile でも使用されます。

INTERNET_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

要求で指定されたホスト名に対してサーバーから返される SSL/PCT ベースの証明書のチェックを無効にします。 WinINet では、ホスト名と単純なワイルドカード規則の照合を比較することで、証明書に対して単純なチェックを使用します。 このフラグは、 HttpOpenRequest と InternetOpenUrl (HTTP 要求の場合) で使用できます。

INTERNET_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

SSL/PCT ベースの証明書の正しい有効期限のチェックを無効にします。 このフラグは、 HttpOpenRequest と InternetOpenUrl (HTTP 要求の場合) で使用できます。

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

この特殊な種類のリダイレクトの検出を無効にします。 このフラグを使用すると、WinINet は HTTPS から HTTP URL へのリダイレクトを透過的に許可します。 このフラグは、 HttpOpenRequest と InternetOpenUrl (HTTP 要求の場合) で使用できます。

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

この特殊な種類のリダイレクトの検出を無効にします。 このフラグを使用すると、WinINet は HTTP から HTTPS URL へのリダイレクトを透過的に許可します。 このフラグは、 HttpOpenRequest と InternetOpenUrl (HTTP 要求の場合) で使用できます。

INTERNET_FLAG_KEEP_CONNECTION

0x00400000

接続にキープアライブ セマンティクス (使用可能な場合) を使用します。 このフラグは、 HttpOpenRequest と InternetOpenUrl (HTTP 要求の場合) で使用されます。 このフラグは、Microsoft Network (MSN)、NTLM、およびその他の種類の認証に必要です。

INTERNET_FLAG_MAKE_PERSISTENT

0x02000000

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

INTERNET_FLAG_MUST_CACHE_REQUEST

0x00000010

優先値と同じ INTERNET_FLAG_NEED_FILE。 ファイルをキャッシュできない場合は、一時ファイルを作成します。 このフラグは、 FtpFindFirstFile、 FtpGetFile、 FtpOpenFile、 FtpPutFile、 HttpOpenRequest、 InternetOpenUrl で使用できます。

Windows XP および Windows Server 2003 R2 以前:GopherFindFirstFile および GopherOpenFile でも使用されます。

INTERNET_FLAG_NEED_FILE

0x00000010

ファイルをキャッシュできない場合は、一時ファイルを作成します。 このフラグは、 FtpFindFirstFile、 FtpGetFile、 FtpOpenFile、 FtpPutFile、 HttpOpenRequest、 InternetOpenUrl で使用できます。

Windows XP および Windows Server 2003 R2 以前:GopherFindFirstFile および GopherOpenFile でも使用されます。

INTERNET_FLAG_NO_AUTH

0x00040000

認証は自動的に試行されません。 このフラグは、 HttpOpenRequest と InternetOpenUrl (HTTP 要求の場合) で使用できます。

INTERNET_FLAG_NO_AUTO_REDIRECT

0x00200000

HttpSendRequest でリダイレクトを自動的に処理しません。 このフラグは、HTTP 要求に InternetOpenUrl で使用することもできます。

INTERNET_FLAG_NO_CACHE_WRITE

0x04000000

返されたエンティティをキャッシュに追加しません。 このフラグは、 、HttpOpenRequest、 および InternetOpenUrl によって使用されます。

Windows XP および Windows Server 2003 R2 以前:GopherFindFirstFile および GopherOpenFile でも使用されます。

INTERNET_FLAG_NO_COOKIES

0x00080000

要求に Cookie ヘッダーを自動的に追加せず、返された Cookie を Cookie データベースに自動的に追加しません。 このフラグは、 HttpOpenRequest と InternetOpenUrl (HTTP 要求の場合) で使用できます。

INTERNET_FLAG_NO_UI

0x00000200

Cookie ダイアログ ボックスを無効にします。 このフラグは、 HttpOpenRequest と InternetOpenUrl (HTTP 要求のみ) で使用できます。

INTERNET_FLAG_OFFLINE

0x01000000

INTERNET_FLAG_FROM_CACHEと同じです。 ネットワーク要求を行いません。 すべてのエンティティがキャッシュから返されます。 要求された項目がキャッシュにない場合は、ERROR_FILE_NOT_FOUNDなどの適切なエラーが返されます。 InternetOpen 関数のみがこのフラグを使用します。

INTERNET_FLAG_PASSIVE

0x08000000

パッシブ FTP セマンティクスを使用します。 このフラグを使用するのは 、InternetConnect と InternetOpenUrl のみです。 InternetConnect は FTP 要求にこのフラグを使用し、 InternetOpenUrl は FTP ファイルとディレクトリにこのフラグを使用します。

INTERNET_FLAG_PRAGMA_NOCACHE

0x00000100

キャッシュされたコピーがプロキシ上に存在する場合でも、配信元サーバーによって要求が強制的に解決されます。 InternetOpenUrl 関数 (HTTP および HTTPS 要求のみ) と HttpOpenRequest 関数は、このフラグを使用します。

INTERNET_FLAG_RAW_DATA

0x40000000

FTP ディレクトリ情報を取得するときに 、データをWIN32_FIND_DATA 構造体として返します。 このフラグが指定されていない場合、または CERN プロキシを介して呼び出しが行われた場合、 InternetOpenUrl はディレクトリの HTML バージョンを返します。 InternetOpenUrl 関数のみがこのフラグを使用します。

Windows XP および Windows Server 2003 R2 以前: また、Gopher ディレクトリ情報を取得するときに 、GOPHER_FIND_DATA 構造体を返します。

INTERNET_FLAG_READ_PREFETCH

0x00100000

このフラグは現在無効になっています。

INTERNET_FLAG_RELOAD

0x80000000

要求されたファイル、オブジェクト、またはディレクトリ リストをキャッシュからではなく元のサーバーからダウンロードします。 FtpFindFirstFile、FtpGetFile、FtpOpenFile、FtpPutFile、HttpOpenRequest、および InternetOpenUrl 関数は、このフラグを使用します。

Windows XP および Windows Server 2003 R2 以前:GopherFindFirstFile および GopherOpenFile でも使用されます。

INTERNET_FLAG_RESTRICTED_ZONE

0x00020000

設定されている Cookie が信頼されていないサイトに関連付けられていることを示します。

INTERNET_FLAG_RESYNCHRONIZE

0x00000800

最後にダウンロードされてからリソースが変更された場合は、HTTP リソースを再読み込みします。 すべての FTP リソースが再読み込みされます。 このフラグは、 FtpFindFirstFile、 FtpGetFile、 FtpOpenFile、 FtpPutFile、 HttpOpenRequest、 InternetOpenUrl で使用できます。

Windows XP および Windows Server 2003 R2 以前:また、GopherFindFirstFile と GopherOpenFile で使用され、Gopher リソースが再読み込みされます。

INTERNET_FLAG_SECURE

0x00800000

安全なトランザクション セマンティクスを使用します。 これは、Secure Sockets Layer/Private Communications Technology (SSL/PCT) の使用に変換され、HTTP 要求でのみ意味があります。 このフラグは HttpOpenRequest と InternetOpenUrl によって使用されますが、URL に https:// が表示される場合は冗長です。 InternetConnect 関数は、HTTP 接続にこのフラグを使用します。この接続で作成されたすべての要求ハンドルは、このフラグを継承します。

INTERNET_FLAG_TRANSFER_ASCII

0x00000001

ファイルを ASCII (FTP のみ) として転送します。 このフラグは、 FtpOpenFile、 FtpGetFile、 および FtpPutFile で使用できます。

INTERNET_FLAG_TRANSFER_BINARY

0x00000002

ファイルをバイナリとして転送します (FTP のみ)。 このフラグは、 FtpOpenFile、 FtpGetFile、 および FtpPutFile で使用できます。

INTERNET_NO_CALLBACK

0x00000000

その API に対してコールバックを行う必要がないことを示します。 これは、非同期操作を許可する関数の dxContext パラメーターに使用されます。

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 以降が必要です。

WININET_API_FLAG_ASYNC

0x00000001

非同期操作を強制します。

WININET_API_FLAG_SYNC

0x00000004

同期操作を強制します。

WININET_API_FLAG_USE_CONTEXT

0x00000008

0 に設定されている場合でも、API でコンテキスト値を強制的に使用します。

解説

要件