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 |