HTTP_HEADER_ID 枚举 (http.h)

HTTP_HEADER_ID 枚举类型列出 HTTP 请求和响应的已知标头，并将数组索引与每个此类标头相关联。 它用于调整和访问HTTP_REQUEST_HEADERS和HTTP_RESPONSE_HEADERS结构的 KnownHeaders 数组成员。

语法

typedef enum _HTTP_HEADER_ID {
  HttpHeaderCacheControl = 0,
  HttpHeaderConnection = 1,
  HttpHeaderDate = 2,
  HttpHeaderKeepAlive = 3,
  HttpHeaderPragma = 4,
  HttpHeaderTrailer = 5,
  HttpHeaderTransferEncoding = 6,
  HttpHeaderUpgrade = 7,
  HttpHeaderVia = 8,
  HttpHeaderWarning = 9,
  HttpHeaderAllow = 10,
  HttpHeaderContentLength = 11,
  HttpHeaderContentType = 12,
  HttpHeaderContentEncoding = 13,
  HttpHeaderContentLanguage = 14,
  HttpHeaderContentLocation = 15,
  HttpHeaderContentMd5 = 16,
  HttpHeaderContentRange = 17,
  HttpHeaderExpires = 18,
  HttpHeaderLastModified = 19,
  HttpHeaderAccept = 20,
  HttpHeaderAcceptCharset = 21,
  HttpHeaderAcceptEncoding = 22,
  HttpHeaderAcceptLanguage = 23,
  HttpHeaderAuthorization = 24,
  HttpHeaderCookie = 25,
  HttpHeaderExpect = 26,
  HttpHeaderFrom = 27,
  HttpHeaderHost = 28,
  HttpHeaderIfMatch = 29,
  HttpHeaderIfModifiedSince = 30,
  HttpHeaderIfNoneMatch = 31,
  HttpHeaderIfRange = 32,
  HttpHeaderIfUnmodifiedSince = 33,
  HttpHeaderMaxForwards = 34,
  HttpHeaderProxyAuthorization = 35,
  HttpHeaderReferer = 36,
  HttpHeaderRange = 37,
  HttpHeaderTe = 38,
  HttpHeaderTranslate = 39,
  HttpHeaderUserAgent = 40,
  HttpHeaderRequestMaximum = 41,
  HttpHeaderAcceptRanges = 20,
  HttpHeaderAge = 21,
  HttpHeaderEtag = 22,
  HttpHeaderLocation = 23,
  HttpHeaderProxyAuthenticate = 24,
  HttpHeaderRetryAfter = 25,
  HttpHeaderServer = 26,
  HttpHeaderSetCookie = 27,
  HttpHeaderVary = 28,
  HttpHeaderWwwAuthenticate = 29,
  HttpHeaderResponseMaximum = 30,
  HttpHeaderMaximum = 41
} HTTP_HEADER_ID, *PHTTP_HEADER_ID;

常量

HttpHeaderCacheControl 值： 0 用于指定请求或响应链上的缓存行为，重写默认缓存算法。
HttpHeaderConnection 值：1 允许发送方指定该特定连接所需的选项。 它们仅用于单个连接，不能由代理通过其他连接进行通信。
HttpHeaderDate 值： 2 Date 是一个常规标头字段，用于指示发送请求或响应的时间。
HttpHeaderKeepAlive 值： 3 根据 keepalive XML 元素 (请参阅 RFC 2518 第 12.12.1 节，第 66 页) ;KeepAlive 中包含的 URI 列表 标头在复制后必须是“live” () 移动到目标。
HttpHeaderPragma 值： 4 用于包含可选的特定于实现的指令，这些指令可能应用于请求/响应链中的任何收件人。
HttpHeaderTrailer 值： 5 指示指定的标头字段存在于使用分块传输编码进行编码的消息的尾部中。
HttpHeaderTransferEncoding 值： 6 指示已对传输中的消息正文应用了哪些转换（如果有）。
HttpHeaderUpgrade 值： 7 允许客户端指定一个或多个其他通信协议，如果服务器可以符合，则它希望使用。
HttpHeaderVia 值： 8 Via 标头字段指示请求采用的路径。
HttpHeaderWarning 值： 9 这是一个响应标头，其中包含 3 位警告代码以及原因短语。
HttpHeaderAllow 值： 10 Lists请求 URI 标识的资源支持的方法集。
HttpHeaderContentLength 值： 11 消息正文的大小（以十进制字节为单位）。
HttpHeaderContentType 值： 12 消息正文的媒体类型。
HttpHeaderContentEncoding 值： 13 消息正文的编码方案。
HttpHeaderContentLanguage 值： 14 提供目标受众的自然语言。
HttpHeaderContentLocation 值： 15 当该实体可从与请求资源 URI 不同的位置访问时，消息中包含的实体的资源的位置。
HttpHeaderContentMd5 值： 16 用于检查 (实体正文的 MIC) 提供端到端消息完整性的实体正文的 MD5 摘要。
HttpHeaderContentRange 值： 17 内容范围标头随部分实体正文一起发送，以指定应在完整实体正文中应用部分正文的位置。
HttpHeaderExpires 值： 18 消息内容过期的日期和时间。
HttpHeaderLastModified 值： 19 指示源服务器认为上次修改变体的日期和时间。
HttpHeaderAccept 值： 20 与 INVITE、OPTIONS 和 REGISTER 方法一起使用，以指示响应中可接受的媒体类型。
HttpHeaderAcceptCharset 值： 21 指示响应可接受的字符集。
HttpHeaderAcceptEncoding 值： 22 响应中可接受的内容编码。
HttpHeaderAcceptLanguage 值： 23 客户端用于向服务器指示它希望接收原因短语、会话说明或状态响应的语言。
HttpHeaderAuthorization 值： 24 用户代理可以通过将授权请求标头字段与请求一起发送来向服务器进行身份验证。 字段包含用户正在请求的域的凭据。
HttpHeaderCookie 值： 25 Cookie 请求标头包含用于维护服务器客户端状态的数据。 Cookie 数据是从使用 HttpHeaderSetCookie 发送的响应中获取的。
HttpHeaderExpect 值： 26 指示客户端所需的特定服务器行为。
HttpHeaderFrom 值： 27 “发件人标头”字段指定 SIP 请求或响应消息的发起方。
HttpHeaderHost 值： 28 指定所请求资源的 Internet 主机和端口号。 这是从用户或引用资源提供的原始 URI 获取的。
HttpHeaderIfMatch 值： 29 If-Match 请求标头字段与 方法一起使用，使其具有条件性。 具有以前从资源获取的一个或多个实体的客户端可以通过在“If-Match 标头”字段中包含其中一个实体的关联实体标记列表来验证其中一个实体是否为最新实体。
HttpHeaderIfModifiedSince 值： 30 If-Modified-Since 请求标头字段与 方法一起使用，使其具有条件性。 如果自此字段中指定的时间以来未修改请求的变体，则不会从服务器返回实体;相反，返回的 304 (未修改) 响应没有任何消息正文。
HttpHeaderIfNoneMatch 值： 31 If-None-Match request-header 字段与方法一起使用以生成 它有条件。 当客户端从资源获取一个或多个实体时，它可以验证这些实体是否不是 当前，方法是在 中包括其关联实体标记的列表 If-None-Match 标头字段。 此功能的目的是允许 缓存信息的高效更新，最低数量 事务开销，以及 防止 PUT 等方法 在客户端无意中修改现有资源 认为资源不存在。
HttpHeaderIfRange 值： 32 如果客户端在其缓存中具有实体的部分副本，并且希望 若要获取整个实体的最新副本，则为 可以使用 If-Range 标头。 非正式地说，其含义是，“如果实体未更改，则发送 我缺少) (部分;否则，请将整个新文件发送给我 entity。”
HttpHeaderIfUnmodifiedSince 值： 33 If-Unmodified-Since request-header 字段与 方法一起使用 使其有条件。 如果请求的资源尚未修改 从此字段中指定的时间开始，服务器将执行 请求的操作，就好像 If-Unmodified-Since 标头不是 存在，但 如果请求的资源已修改， 服务器返回 ) 先决条件失败 (412 错误。
HttpHeaderMaxForwards 值： 34 可以转发请求的代理或网关的最大数目。
HttpHeaderProxyAuthorization 值： 35 客户端使用此标头字段通过代理来标识自身。
HttpHeaderReferer 值： 36 允许客户端指定从中获取请求 URI 的资源的地址 (URI) ，以便服务器受益。
HttpHeaderRange 值： 37 允许客户端请求实体的一部分，而不是整个实体。
HttpHeaderTe 值： 38 此标头字段包含 SIP 请求或响应消息的收件人。
HttpHeaderTranslate 值： 39 允许客户端指定是需要所请求内容的源表示形式还是编程解释。
HttpHeaderUserAgent 值： 40 指示客户端在响应中接受的扩展传输编码，以及客户端是否接受分块传输编码中的尾部字段。
HttpHeaderRequestMaximum 值： 41 不是实际指定标头的值;相反，它用于计算枚举的请求标头。
HttpHeaderAcceptRanges 值： 20 允许服务器指示接受资源的范围请求。
HttpHeaderAge 值： 21 传达发送方对源服务器上生成响应 (或其重新验证) 以来的估计时间量。
HttpHeaderEtag 值： 22 为请求的变体提供实体标记的当前值。
HttpHeaderLocation 值： 23 用于将收件人重定向到请求 URI 以外的位置，以便完成请求或标识新资源。
HttpHeaderProxyAuthenticate 值： 24 必须作为 407 响应的一部分包含的响应字段。 字段包括适用于此请求 URI 的代理的身份验证方案和参数。
HttpHeaderRetryAfter 值： 25 请求客户端预期服务不可用的时间长度。
HttpHeaderServer 值： 26 这是一个响应标头字段，其中包含有关正在处理请求的服务器的信息。
HttpHeaderSetCookie 值： 27 set-cookie 响应标头包含用于在将来使用 HttpHeaderCookie 发送的请求中维护客户端状态的数据。
HttpHeaderVary 值： 28 指示请求标头字段集，这些字段完全确定在响应为全新时，是否允许缓存使用响应在不重新验证的情况下回复后续请求。
HttpHeaderWwwAuthenticate 值： 29 WWW_Authenticate标头字段包含适用于请求 URI 的身份验证方案和参数。
HttpHeaderResponseMaximum 值： 30 不是实际指定标头的值;相反，它用于计算枚举的响应标头。
HttpHeaderMaximum 值： 41 不是实际指定标头的值;相反，它用于计算所有枚举标头。

要求

要求	值
最低受支持的客户端	Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	http.h

另请参阅

HTTP_REQUEST_HEADERS

HTTP_RESPONSE_HEADERS