勇芳软件工作室.汉化:  WinHTTP Reference > WinHTTP Constants >

Query Info Flags

Previous pageReturn to chapter overview

这些属性和修饰符由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响应头字段,其中包含发件人对始发服务器生成响应后的时间量的估计。

 

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 request-header字段的内容。

 

WINHTTP_QUERY_IF_MODIFIED_SINCE

 

检索If-Modified-Since头文件的内容。

 

WINHTTP_QUERY_IF_NONE_MATCH

 

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

 

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

 

检索位置响应头中使用的绝对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

 

检索代理连接头。

 

WINHTTP_QUERY_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

 

检索“除非修改的头”。

 

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结构,不需要应用程序来解析数据。用于其值为日期/时间字符串(例如“上次修改时间”)的标头。