通过

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

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

WINHTTP_QUERY_ALLOW

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

WINHTTP_QUERY_AUTHENTICATION_INFO

检索Authentication-Info标头。

WINHTTP_QUERY_AUTHORIZATION

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

WINHTTP_QUERY_CACHE_CONTROL

检索缓存控件指令。

WINHTTP_QUERY_CONNECTION

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

WINHTTP_QUERY_CONTENT_BASE

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

WINHTTP_QUERY_CONTENT_DESCRIPTION

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

WINHTTP_QUERY_CONTENT_DISPOSITION

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

WINHTTP_QUERY_CONTENT_ENCODING

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

WINHTTP_QUERY_CONTENT_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

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

WINHTTP_QUERY_EXPIRES

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

WINHTTP_QUERY_FORWARDED

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

WINHTTP_QUERY_FROM

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

WINHTTP_QUERY_HOST

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

WINHTTP_QUERY_IF_MATCH

检索If-Match请求标头字段的内容。

WINHTTP_QUERY_IF_MODIFIED_SINCE

检索 If-Modified-Since 标头的内容。

WINHTTP_QUERY_IF_NONE_MATCH

检索 If-None-Match request-header 字段的内容。

WINHTTP_QUERY_IF_RANGE

检索If-Range请求标头字段的内容。 如果与客户端应用程序缓存中实体的部分副本相关的实体尚未更新，则此标头允许客户端应用程序检查。 如果实体尚未更新，请发送客户端应用程序缺少的部分。 如果实体已更新，则发送整个更新后的实体。

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

接收用于构造邮件的多用途 Internet 邮件扩展 (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

接收部分或全部 URI，通过该 URI 可以标识 Request-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) 。 查询响应尾部。 在查询响应尾部之前，必须调用 WinHttpReadData ，直到它返回 0 字节读取。

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

另请参阅