HTTP_RESPONSE_V1 結構 (HTTP.h)
HTTP_RESPONSE_V1結構包含與 HTTP 回應相關聯的資料。
請勿直接在程式碼中使用 HTTP_RESPONSE_V1 ;請改用 HTTP_RESPONSE ,以確保會根據編譯器代碼的作業系統,使用適當的版本。
語法
typedef struct _HTTP_RESPONSE_V1 {
ULONG Flags;
HTTP_VERSION Version;
USHORT StatusCode;
USHORT ReasonLength;
PCSTR pReason;
HTTP_RESPONSE_HEADERS Headers;
USHORT EntityChunkCount;
PHTTP_DATA_CHUNK pEntityChunks;
} HTTP_RESPONSE_V1, *PHTTP_RESPONSE_V1;
成員
Flags
選擇性記錄旗標會變更預設回應行為。 這些可以是其中一個 HTTP_RESPONSE_FLAG 值。
Version
忽略此成員;回應一律是 HTTP/1.1 回應。
StatusCode
描述 HTTP 要求結果的數值狀態碼 (,例如 200 表示 「確定」或 404 表示「找不到」) 。 如需詳細資訊和這些程式碼的清單,請參閱 RFC 2616 第 10節。
如果要求導向至保留但未註冊的 URL,表示處理它的適當應用程式未執行,則 HTTP Server API 本身會傳回狀態碼為 400 的回應,表示「不正確的要求」。 這對應用程式而言是透明的。 此處偏好使用程式碼 400 到 503 (「伺服器無法使用」) ,因為後者會由某些智慧型負載平衡器解譯為表示伺服器已超載。
ReasonLength
pReason成員所指向之字串的大小,以位元組為單位,不包含終止 Null。 可能是零。
pReason
人類可讀取且以 Null 結尾的可列印字元字串指標,其描述 HTTP 要求的結果 (例如「OK」 或 「Not Found」) 。
Headers
包含此回應中所用標頭 的HTTP_RESPONSE_HEADERS 結構。
EntityChunkCount
pEntityChunks陣列中指定的實體主體資料區塊數目。 這個數位不能超過 100。 如果回應沒有實體主體,則此成員必須為零。
pEntityChunks
一起指定構成回應實體主體之所有資料區塊 的HTTP_DATA_CHUNK 結構陣列。
需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
標頭 | HTTP.h |