クエリ情報フラグ (Winhttp.h)

これらの属性と修飾子は、 WinHttpQueryHeaders によって使用されます。

属性フラグは、取得する情報を示すために WinHttpQueryHeaders によって使用されます。 ほとんどの属性フラグは、特定の HTTP ヘッダーに直接マップされます。 また、特定のヘッダーに関連しない特殊なフラグ (WINHTTP_QUERY_RAW_HEADERS など) もあります。

WINHTTP_QUERY_ACCEPT

応答で許容されるメディアの種類を取得します。

WINHTTP_QUERY_ACCEPT_CHARSET

応答の許容される文字セットを取得します。

WINHTTP_QUERY_ACCEPT_ENCODING

応答の許容されるコンテンツ コーディング値を取得します。

WINHTTP_QUERY_ACCEPT_LANGUAGE

応答に使用できる自然言語を取得します。

WINHTTP_QUERY_ACCEPT_RANGES

リソースに対して受け入れられる範囲要求の種類を取得します。

WINHTTP_QUERY_AGE

Age response-header フィールドを取得します。このフィールドには、送信元サーバーで応答が生成されてからの時間の送信者の見積もりが含まれます。

WINHTTP_QUERY_ALLOW

サーバーでサポートされている HTTP 動詞 を受け取ります。

WINHTTP_QUERY_AUTHENTICATION_INFO

Authentication-Info ヘッダーを取得します。

WINHTTP_QUERY_AUTHORIZATION

要求に使用される承認資格情報を取得します。

WINHTTP_QUERY_CACHE_CONTROL

キャッシュ 制御ディレクティブを取得します。

WINHTTP_QUERY_CONNECTION

特定の接続に対して指定されたオプションを取得し、それ以降の接続を介してプロキシによって通信することはできません。

WINHTTP_QUERY_CONTENT_BASE

エンティティ内の相対 URL を解決するベースの Uniform Resource Identifier (URI) を取得します。

WINHTTP_QUERY_CONTENT_DESCRIPTION

互換性のために残されています。 レガシ アプリケーションの互換性のために維持されます。

WINHTTP_QUERY_CONTENT_DISPOSITION

互換性のために残されています。 レガシ アプリケーションの互換性のために維持されます。

WINHTTP_QUERY_CONTENT_ENCODING

リソース全体に適用されている追加のコンテンツ コーディングを取得します。

WINHTTP_QUERY_CONTENT_ID

コンテンツ ID を取得します。

WINHTTP_QUERY_CONTENT_LANGUAGE

コンテンツが書き込まれる言語を取得します。

WINHTTP_QUERY_CONTENT_LENGTH

リソースのサイズをバイト単位で取得します。

WINHTTP_QUERY_CONTENT_LOCATION

メッセージで囲まれたエンティティのリソースの場所を取得します。

WINHTTP_QUERY_CONTENT_MD5

エンティティ本文のエンド ツー エンドのメッセージ整合性チェックを提供するために、エンティティ本文の MD5 ダイジェストを取得します。 詳細については、「 RFC 1864」を参照してください。

WINHTTP_QUERY_CONTENT_RANGE

部分エンティティ本文を挿入する必要がある完全なエンティティ本体内の場所と、完全なエンティティ本文の合計サイズを取得します。

WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING

エンティティ本文に適用できるエンコード変換を取得します。 既に適用されている場合、適用が必要な場合、または必要に応じて適用できる場合があります。

WINHTTP_QUERY_CONTENT_TYPE

テキストや html などのリソースのコンテンツ タイプを受け取ります。

WINHTTP_QUERY_COOKIE

要求に関連付けられているすべての Cookie を取得します。

WINHTTP_QUERY_COST

サポートされていません。

WINHTTP_QUERY_CUSTOM

WinHttpQueryHeaders が pwszName パラメーターで指定されたヘッダー名を検索し、ヘッダー情報を lpBuffer に格納します。 アプリケーションでは 、WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT を使用して、このクエリがすべてのヘッダーの受信を待機する最大時間を制限できます。

WINHTTP_QUERY_DATE

メッセージが送信された日時を受信します。

WINHTTP_QUERY_DERIVED_FROM

サポートされていません。

WINHTTP_QUERY_ETAG

関連付けられているエンティティのエンティティ タグを取得します。

WINHTTP_QUERY_EXPECT

クライアント アプリケーションが 100 シリーズの応答を想定する必要があるかどうかを示す Expect ヘッダーを取得します。

WINHTTP_QUERY_EXPIRES

リソースが古いと見なされる日時を受け取ります。

WINHTTP_QUERY_FORWARDED

互換性のために残されています。 レガシ アプリケーションの互換性のために維持されます。

WINHTTP_QUERY_FROM

From ヘッダーが指定されている場合に、要求元の ユーザー エージェント を制御するユーザーの電子メール アドレスを取得します。

WINHTTP_QUERY_HOST

要求されているリソースのインターネット ホストとポート番号を取得します。

WINHTTP_QUERY_IF_MATCH

If-Match request-header フィールドの内容を取得します。

WINHTTP_QUERY_IF_MODIFIED_SINCE

If-Modified-Since ヘッダーの内容を取得します。

WINHTTP_QUERY_IF_NONE_MATCH

If-None-Match request-header フィールドの内容を取得します。

WINHTTP_QUERY_IF_RANGE

If-Range request-header フィールドの内容を取得します。 このヘッダーを使用すると、クライアント アプリケーションは、クライアント アプリケーションのキャッシュ内のエンティティの部分コピーに関連するエンティティが更新されていないかどうかを確認できます。 エンティティが更新されていない場合は、クライアント アプリケーションが見つからない部分を送信します。 エンティティが更新された場合は、更新されたエンティティ全体を送信します。

WINHTTP_QUERY_IF_UNMODIFIED_SINCE

If-Unmodified-Since request-header フィールドの内容を取得します。

WINHTTP_QUERY_LINK

互換性のために残されています。 レガシ アプリケーションの互換性のために維持されます。

WINHTTP_QUERY_LAST_MODIFIED

リソースが最後に変更された日時を受け取ります。 日付と時刻は、サーバーによって決定されます。

WINHTTP_QUERY_LOCATION

Location response-header で使用される絶対 URI を取得します。

WINHTTP_QUERY_MAX

WINHTTP_QUERY_* 値の最大値を示します。 クエリ フラグではありません。

WINHTTP_QUERY_MAX_FORWARDS

要求を次の受信サーバーに転送できるプロキシまたはゲートウェイの数を取得します。

WINHTTP_QUERY_MESSAGE_ID

サポートされていません。

WINHTTP_QUERY_MIME_VERSION

メッセージの作成に使用された多目的インターネット メール拡張機能 (MIME) プロトコルのバージョンを受信します。

WINHTTP_QUERY_ORIG_URI

互換性のために残されています。 レガシ アプリケーションの互換性のために維持されます。

WINHTTP_QUERY_PRAGMA

要求/応答チェーンに沿って任意の受信者に適用される可能性がある実装固有のディレクティブを受け取ります。

WINHTTP_QUERY_PROXY_AUTHENTICATE

プロキシによって返される認証スキームと領域を取得します。

WINHTTP_QUERY_PROXY_AUTHORIZATION

認証を必要とするプロキシに対してユーザーを識別するために使用されるヘッダーを取得します。 このヘッダーは、要求がサーバーに送信される前にのみ取得できます。

WINHTTP_QUERY_PROXY_CONNECTION

Proxy-Connection ヘッダーを取得します。

WINHTTP_QUERY_PROXY_SUPPORT

Proxy-Support ヘッダーを取得します。

WINHTTP_QUERY_PUBLIC

このサーバーで使用できる HTTP 動詞を受け取ります。

WINHTTP_QUERY_RANGE

エンティティのバイト範囲を取得します。

WINHTTP_QUERY_RAW_HEADERS

サーバーから返されたすべてのヘッダーを受信します。 各ヘッダーは "\0" で終了します。 追加の "\0" を指定すると、ヘッダーの一覧が終了します。

WINHTTP_QUERY_RAW_HEADERS_CRLF

サーバーから返されたすべてのヘッダーを受信します。 各ヘッダーは、キャリッジ リターン/ライン フィード (CR/LF) シーケンスで区切られます。

WINHTTP_QUERY_REFERER

要求された URI が取得されたリソースの URI を受信します。

WINHTTP_QUERY_REFRESH

互換性のために残されています。 レガシ アプリケーションの互換性のために維持されます。

WINHTTP_QUERY_REQUEST_METHOD

要求で使用されている HTTP 動詞 (通常は GET または POST) を受け取ります。

WINHTTP_QUERY_RETRY_AFTER

サービスが使用できないと予想される時間を取得します。

WINHTTP_QUERY_SERVER

元のサーバーが要求を処理するために使用するソフトウェアに関する情報を取得します。

WINHTTP_QUERY_SET_COOKIE

要求に対して設定された Cookie の値を受け取ります。

WINHTTP_QUERY_STATUS_CODE

サーバーから返された状態コードを受け取ります。 使用可能な値の一覧については、「 HTTP 状態コード」を参照してください。

WINHTTP_QUERY_STATUS_TEXT

応答行でサーバーから返された追加のテキストを受け取ります。

WINHTTP_QUERY_TITLE

互換性のために残されています。 レガシ アプリケーションの互換性のために維持されます。

WINHTTP_QUERY_TRANSFER_ENCODING

送信者と受信者の間で安全に転送できるように、メッセージ本文に適用されている変換の種類を取得します。

WINHTTP_QUERY_UNLESS_MODIFIED_SINCE

Unless-Modified-Since ヘッダーを取得します。

WINHTTP_QUERY_UPGRADE

サーバーでサポートされている追加の通信プロトコルを取得します。

WINHTTP_QUERY_URI

Request-URI リソースを識別できる URI の一部またはすべてを受け取ります。

WINHTTP_QUERY_USER_AGENT

要求を行ったユーザー エージェントに関する情報を取得します。

WINHTTP_QUERY_VARY

サーバー駆動型ネゴシエーションを使用して、応答の使用可能な表現からエンティティが選択されたことを示すヘッダーを取得します。

WINHTTP_QUERY_VERSION

状態行に存在する HTTP バージョンを取得します。

WINHTTP_QUERY_VIA

要求時にユーザー エージェントとサーバーの間、および応答時に配信元サーバーとクライアントの間の中間プロトコルと受信者を取得します。

WINHTTP_QUERY_WARNING

応答状態コードに反映されない可能性がある応答の状態に関する追加情報を取得します。

WINHTTP_QUERY_WWW_AUTHENTICATE

サーバーによって返される認証スキームと領域を取得します。

修飾子フラグは、要求を変更するために属性フラグと組み合わせて使用されます。 修飾子フラグは、返されるデータの形式を変更するか、 WinHttpQueryHeaders 関数が情報を検索する場所を示します。

WINHTTP_QUERY_FLAG_NUMBER

値が数値であるヘッダー (状態コードなど) の 32 ビット数値としてデータを返します。

WINHTTP_QUERY_FLAG_REQUEST_HEADERS

クエリ要求ヘッダーのみ。

WINHTTP_QUERY_FLAG_SYSTEMTIME

ヘッダー値を SYSTEMTIME 構造体として返します。これは、アプリケーションがデータを解析する必要はありません。 値が日付/時刻文字列 ("Last-Modified-Time" など) のヘッダーに使用します。

WINHTTP_QUERY_FLAG_TRAILERS

Windows 11 バージョン 21H2 (10.0;ビルド 22000)。 応答トレーラーを照会します。 応答トレーラーのクエリを実行する前に、読み取った 0 バイトが返されるまで WinHttpReadData を呼び出す必要があります。

WINHTTP_QUERY_FLAG_WIRE_ENCODING

Windows 11 バージョン 21H2 (10.0;ビルド 22000)。 既定では、 WinHttpQueryHeaders はクエリされたヘッダーを返す前に Unicode 変換を実行します。 このフラグが設定されている場合、WinHttp は、この変換を実行せずに、呼び出し元にヘッダーを返します。

要件

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

関連項目

• WinHTTP バージョン