HTTP_RESPONSE_V1 結構 (HTTP.h)

發行項
08/24/2023

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

另請參閱

HTTP_RESPONSE_HEADERS

HTTP_RESPONSE_V2

HttpSendHttpResponse

HTTP_RESPONSE_V1 結構 (HTTP.h)

語法

成員

需求

另請參閱

意見反應

意見反應

其他資源