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

次の一覧には、 HttpQueryInfo と QueryInfo で使用される属性と修飾子 が含まれています。

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

HTTP_QUERY_ACCEPT

24

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

HTTP_QUERY_ACCEPT_CHARSET

25

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

HTTP_QUERY_ACCEPT_ENCODING

26

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

HTTP_QUERY_ACCEPT_LANGUAGE

27

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

HTTP_QUERY_ACCEPT_RANGES

42

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

HTTP_QUERY_AGE

48

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

HTTP_QUERY_ALLOW

7

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

HTTP_QUERY_AUTHORIZATION

28

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

HTTP_QUERY_CACHE_CONTROL

49

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

HTTP_QUERY_CONNECTION

23

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

HTTP_QUERY_CONTENT_BASE

50

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

HTTP_QUERY_CONTENT_DESCRIPTION

4

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

HTTP_QUERY_CONTENT_DISPOSITION

47

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

HTTP_QUERY_CONTENT_ENCODING

29

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

HTTP_QUERY_CONTENT_ID

3

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

HTTP_QUERY_CONTENT_LANGUAGE

6

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

HTTP_QUERY_CONTENT_LENGTH

5

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

HTTP_QUERY_CONTENT_LOCATION

51

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

HTTP_QUERY_CONTENT_MD5

52

エンティティ本文のエンド ツー エンドメッセージ整合性チェック (MIC) を提供するために、エンティティ本文の MD5 ダイジェストを取得します。 詳細については、RFC1864 の Content-MD5 ヘッダー フィールド https://ftp.isi.edu/in-notes/rfc1864.txt() を参照してください。

HTTP_QUERY_CONTENT_RANGE

53

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

HTTP_QUERY_CONTENT_TRANSFER_ENCODING

2

リソースに適用されている追加のコンテンツ コーディングを受け取ります。

HTTP_QUERY_CONTENT_TYPE

1

リソースのコンテンツ タイプ (text/html など) を受け取ります。

HTTP_QUERY_COOKIE

44

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

HTTP_QUERY_COST

15

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

HTTP_QUERY_CUSTOM

65,535

HttpQueryInfo でlpvBuffer で指定されたヘッダー名を検索し、ヘッダー データを lpvBuffer に格納します。

HTTP_QUERY_DATE

9

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

HTTP_QUERY_DERIVED_FROM

14

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

HTTP_QUERY_ECHO_HEADERS

73

現在、実装されていません。

HTTP_QUERY_ECHO_HEADERS_CRLF

74

現在、実装されていません。

HTTP_QUERY_ECHO_REPLY

72

現在、実装されていません。

HTTP_QUERY_ECHO_REQUEST

71

現在、実装されていません。

HTTP_QUERY_ETAG

54

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

HTTP_QUERY_EXPECT

68

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

HTTP_QUERY_EXPIRES

10

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

HTTP_QUERY_FORWARDED

30

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

HTTP_QUERY_FROM

31

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

HTTP_QUERY_HOST

55

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

HTTP_QUERY_IF_MATCH

56

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

HTTP_QUERY_IF_MODIFIED_SINCE

32

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

HTTP_QUERY_IF_NONE_MATCH

57

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

HTTP_QUERY_IF_RANGE

58

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

HTTP_QUERY_IF_UNMODIFIED_SINCE

59

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

HTTP_QUERY_LAST_MODIFIED

11

サーバーがリソースが最後に変更されたと判断した日時を受け取ります。

HTTP_QUERY_LINK

16

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

HTTP_QUERY_LOCATION

33

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

HTTP_QUERY_MAX

78

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

HTTP_QUERY_MAX_FORWARDS

60

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

HTTP_QUERY_MESSAGE_ID

12

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

HTTP_QUERY_MIME_VERSION

0

メッセージの構築に使用された MIME プロトコルのバージョンを受け取ります。

HTTP_QUERY_ORIG_URI

34

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

HTTP_QUERY_PRAGMA

17

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

HTTP_QUERY_PROXY_AUTHENTICATE

41

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

HTTP_QUERY_PROXY_AUTHORIZATION

61

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

HTTP_QUERY_PROXY_CONNECTION

69

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

HTTP_QUERY_PUBLIC

8

このサーバーで使用できるメソッドを受信します。

HTTP_QUERY_RANGE

62

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

HTTP_QUERY_RAW_HEADERS

21

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

HTTP_QUERY_RAW_HEADERS_CRLF

22

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

HTTP_QUERY_REFERER

35

要求された URI が取得されたリソースの URI (Uniform Resource Identifier) を受け取ります。

HTTP_QUERY_REFRESH

46

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

HTTP_QUERY_REQUEST_METHOD

45

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

HTTP_QUERY_RETRY_AFTER

36

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

HTTP_QUERY_SERVER

37

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

HTTP_QUERY_SET_COOKIE

43

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

HTTP_QUERY_STATUS_CODE

19

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

HTTP_QUERY_STATUS_TEXT

20

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

HTTP_QUERY_TITLE

38

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

HTTP_QUERY_TRANSFER_ENCODING

63

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

HTTP_QUERY_UNLESS_MODIFIED_SINCE

70

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

HTTP_QUERY_UPGRADE

64

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

HTTP_QUERY_URI

13

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

HTTP_QUERY_USER_AGENT

39

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

HTTP_QUERY_VARY

65

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

HTTP_QUERY_VERSION

18

サーバーによって返された最後の応答コードを受け取ります。

HTTP_QUERY_VIA

66

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

HTTP_QUERY_WARNING

67

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

HTTP_QUERY_WWW_AUTHENTICATE

40

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

HTTP_QUERY_X_CONTENT_TYPE_OPTIONS

79

X-Content-Type-Options ヘッダー値を取得します。

HTTP_QUERY_P3P

80

P3P ヘッダー値を取得します。

HTTP_QUERY_X_P2P_PEERDIST

81

X-P2P-PeerDist ヘッダー値を取得します。

HTTP_QUERY_TRANSLATE

82

翻訳ヘッダー値を取得します。

HTTP_QUERY_X_UA_COMPATIBLE

83

X-UA-Compatible ヘッダー値を取得します。

HTTP_QUERY_DEFAULT_STYLE

84

Default-Style ヘッダー値を取得します。

HTTP_QUERY_X_FRAME_OPTIONS

85

X-Frame-Options ヘッダー値を取得します。

HTTP_QUERY_X_XSS_PROTECTION

86

X-XSS-Protection ヘッダー値を取得します。

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

HTTP_QUERY_FLAG_COALESCE

0x10000000

実装されていません。

HTTP_QUERY_FLAG_NUMBER

0x20000000

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

HTTP_QUERY_FLAG_REQUEST_HEADERS

0x80000000

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

HTTP_QUERY_FLAG_SYSTEMTIME

0x40000000

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

注釈

必要条件