HTTP_HEADER_ID列舉 (HTTP.h)

HTTP_HEADER_ID列舉類型會列出 HTTP 要求和回應的已知標頭，並將陣列索引與每個這類標頭產生關聯。 其可用來調整和存取HTTP_REQUEST_HEADERS和HTTP_RESPONSE_HEADERS結構的 KnownHeaders 陣列成員。

Syntax

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 允許傳送者指定該特定連線所需的選項。 這些只會用於單一連線，而且不能透過進一步的連線透過 Proxy 進行通訊。
HttpHeaderDate 值： 2 Date 是一般標頭字段，指出傳送要求或響應的時間。
HttpHeaderKeepAlive 值： 3 根據 keepalive XML 元素 (請參閱 RFC 2518，第 12.12.1 節，第 66 頁) ;KeepAlive 中包含的 URI 列表 標頭在複製后必須是「即時」 () 移至目的地。
HttpHeaderPragma 值： 4 用來包含選擇性的實作特定指示詞，這些指示詞可能會套用至要求/回應鏈結中的任何收件者。
HttpHeaderTrailer 值： 5 表示指定的標頭欄位會出現在以區塊傳輸編碼之訊息的結尾。
HttpHeaderTransferEncoding 值： 6 指出已將轉換套用至傳輸中訊息本文的內容。
HttpHeaderUpgrade 值： 7 允許用戶端指定一或多個其他通訊協定，如果伺服器可以符合，則會偏好使用它。
HttpHeaderVia 值： 8 [Via 標頭] 欄位會指出要求所採取的路徑。
HttpHeaderWarning 值： 9 這是包含 3 位數警告程式碼以及原因片語的回應標頭。
HttpHeaderAllow 值： 10 清單 Request-URI 所識別的資源所支援的方法集。
HttpHeaderContentLength 值： 11 以十進位位元組為單位的訊息本文大小。
HttpHeaderContentType 值： 12 訊息本文的媒體類型。
HttpHeaderContentEncoding 值： 13 訊息本文的編碼配置。
HttpHeaderContentLanguage 值： 14 提供預定物件的自然語言。
HttpHeaderContentLocation 值： 15 當該實體可從與要求之資源 URI 不同的位置存取時，包含在訊息中之實體的資源位置位置。
HttpHeaderContentMd5 值： 16 實體主體的 MD5 摘要，用來提供實體主體的端對端訊息完整性檢查 (MIC) 。
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 指定所要求資源的因特網主機和埠號碼。 這會從用戶或參考資源所提供的原始 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 可以轉送要求的 Proxy 或閘道數目上限。
HttpHeaderProxyAuthorization 值： 35 用戶端會使用此標頭欄位來識別自己的 Proxy。
HttpHeaderReferer 值： 36 允許用戶端指定伺服器權益的位址 (URI) 取得 Request-URI 的資源位址。
HttpHeaderRange 值： 37 允許用戶端要求實體的一部分，而不是整個。
HttpHeaderTe 值： 38 此標頭欄位包含 SIP 要求或回應訊息的收件者。
HttpHeaderTranslate 值： 39 可讓用戶端指定它想要要求內容的來源表示或程式設計解譯。
HttpHeaderUserAgent 值： 40 指出客戶端在回應中接受的延伸模組傳輸編碼，以及用戶端是否接受區塊傳輸編碼中的預告片欄位。
HttpHeaderRequestMaximum 值： 41 不是實際指定標頭的值;而是用來計算列舉的要求標頭。
HttpHeaderAcceptRanges 值： 20 允許伺服器指出其接受資源的範圍要求。
HttpHeaderAge 值： 21 傳達傳送者在源伺服器上產生回應 (或其重新驗證) 以來的時間量估計。
HttpHeaderEtag 值： 22 提供所要求變體之實體標籤的目前值。
HttpHeaderLocation 值： 23 用來將收件者重新導向至要求 URI 以外的位置，以完成要求或識別新資源。
HttpHeaderProxyAuthenticate 值： 24 必須包含在 407 回應中的回應欄位。 欄位包含套用至此 Request-URI Proxy 的驗證配置和參數。
HttpHeaderRetryAfter 值： 25 服務預期無法供要求用戶端使用的時間長度。
HttpHeaderServer 值： 26 這是回應標頭欄位，其中包含正在處理要求之伺服器的相關信息。
HttpHeaderSetCookie 值： 27 set-cookie 回應標頭包含用來在後續使用 HttpHeaderCookie 傳送的要求中維護客戶端狀態的數據。
HttpHeaderVary 值： 28 指出完整判斷回應是全新的要求標頭字段集合，而回應是否允許快取使用回應來回復後續要求，而不需重新驗證。
HttpHeaderWwwAuthenticate 值： 29 WWW_Authenticate標頭字段包含適用於 Request-URI 的驗證配置和參數。
HttpHeaderResponseMaximum 值： 30 不是實際指定標頭的值;而是用來計算列舉的響應標頭。
HttpHeaderMaximum 值： 41 不是實際指定標頭的值;而是用來計算所有列舉標頭。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	http.h

另請參閱

HTTP_REQUEST_HEADERS

HTTP_RESPONSE_HEADERS