Share via

查询信息标志 (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

检索“年龄响应标头”字段，其中包含发送方对源服务器上生成响应以来的估计时间量。

HTTP_QUERY_ALLOW

7

接收服务器支持的 HTTP 谓词。

HTTP_QUERY_AUTHORIZATION

28

检索用于请求的授权凭据。

HTTP_QUERY_CACHE_CONTROL

49

检索缓存控件指令。

HTTP_QUERY_CONNECTION

23

检索为特定连接指定的任何选项，并且不能由代理通过其他连接进行通信。

HTTP_QUERY_CONTENT_BASE

50

检索基 URI (统一资源标识符) ，用于解析实体中的相对 URL。

HTTP_QUERY_CONTENT_DESCRIPTION

4

已过时。 仅针对旧版应用程序兼容性进行维护。

HTTP_QUERY_CONTENT_DISPOSITION

47

已过时。 仅针对旧版应用程序兼容性进行维护。

HTTP_QUERY_CONTENT_ENCODING

29

检索已应用于整个资源的任何其他内容编码。

HTTP_QUERY_CONTENT_ID

3

检索内容标识。

HTTP_QUERY_CONTENT_LANGUAGE

6

检索内容所使用的语言。

HTTP_QUERY_CONTENT_LENGTH

5

检索资源的大小（以字节为单位）。

HTTP_QUERY_CONTENT_LOCATION

51

检索消息中包含的实体的资源位置。

HTTP_QUERY_CONTENT_MD5

52

检索实体正文的 MD5 摘要，以便为实体正文提供端到端消息完整性检查 (MIC) 。 有关详细信息，请参阅中的 https://ftp.isi.edu/in-notes/rfc1864.txtRFC1864 Content-MD5 标头字段。

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

65535

使 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

检索 Expect 标头，该标头指示客户端应用程序是否应预期 100 个系列响应。

HTTP_QUERY_EXPIRES

10

接收应将资源视为已过时的日期和时间。

HTTP_QUERY_FORWARDED

30

已过时。 仅针对旧版应用程序兼容性进行维护。

HTTP_QUERY_FROM

31

如果提供了 From 标头，则检索控制请求用户代理的用户的电子邮件地址。

HTTP_QUERY_HOST

55

检索所请求资源的 Internet 主机和端口号。

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

检索位置响应标头中使用的绝对统一资源标识符 (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) 。

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

接收部分或全部统一资源标识符 (URI) ，通过这些 URI 可以标识 Request-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

检索 translate 标头值。

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”。

注解

注意

WinINet 不支持服务器实现。 此外，不应从服务使用它。 对于服务器实现或服务，请使用 Microsoft Windows HTTP Services (WinHTTP) 。

要求

要求 值
最低受支持的客户端
 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
 Windows 2000 Server [仅限桌面应用]
标头
Wininet.h