http.h) (HTTP_RESPONSE_V1 结构

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 服务器 API 本身将返回状态代码为 400 的响应,表示“请求错误”。 这对应用程序是透明的。 此处首选代码 400 而不是 503 (“服务器不可用”) ,因为某些智能负载均衡器将后者解释为指示服务器过载。

ReasonLength

pReason 成员指向的字符串的大小(以字节为单位),不包括终止 null。 可以为零。

pReason

指向用户可读、以 null 结尾的可打印字符字符串的指针,该字符串描述 HTTP 请求的结果 (例如“确定”或“未找到”) 。

Headers

包含此响应中使用的标头 的HTTP_RESPONSE_HEADERS 结构。

EntityChunkCount

pEntityChunks 数组中指定的多个实体主体数据块。 此数字不能超过 100。 如果响应没有实体正文,则此成员必须为零。

pEntityChunks

HTTP_DATA_CHUNK结构的数组,这些结构共同指定构成响应实体主体的所有数据块。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 http.h

另请参阅

HTTP 服务器 API 版本 2.0 结构

HTTP_DATA_CHUNK

HTTP_REQUEST

HTTP_RESPONSE

HTTP_RESPONSE_HEADERS

HTTP_RESPONSE_V2

HttpSendHttpResponse