estructura de HTTP_RESPONSE_V1 (http.h)

  • Artículo

La estructura HTTP_RESPONSE_V1 contiene datos asociados a una respuesta HTTP.

No use HTTP_RESPONSE_V1 directamente en el código; use HTTP_RESPONSE en su lugar para asegurarse de que se usa la versión adecuada, en función del sistema operativo en el que se compila el código.

Sintaxis

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;

Members

Flags

Las marcas de registro opcionales cambian el comportamiento de respuesta predeterminado. Pueden ser uno de los valores de HTTP_RESPONSE_FLAG .

Version

Este miembro se omite; la respuesta siempre es una respuesta HTTP/1.1.

StatusCode

Código de estado numérico que caracteriza el resultado de la solicitud HTTP (por ejemplo, 200 que indica "Ok" o 404 que indica "No encontrado"). Para obtener más información y una lista de estos códigos, consulte la sección 10 de RFC 2616.

Si una solicitud se dirige a una dirección URL reservada pero no registrada, lo que indica que la aplicación adecuada para controlarla no se está ejecutando, la PROPIA API del servidor HTTP devuelve una respuesta con el código de estado 400, lo que indica "Solicitud incorrecta". Esto es transparente para la aplicación. Aquí se prefiere un código 400 a 503 ("Servidor no disponible") porque algunos equilibradores de carga inteligentes interpretan este último como una indicación de que el servidor está sobrecargado.

ReasonLength

Tamaño, en bytes, de la cadena a la que apunta el miembro pReason no incluida la terminación null. Puede ser cero.

pReason

Puntero a una cadena legible y terminada en null de caracteres imprimibles que caracteriza el resultado de la solicitud HTTP (por ejemplo, "Ok" o "No encontrado").

Headers

Estructura HTTP_RESPONSE_HEADERS que contiene los encabezados usados en esta respuesta.

EntityChunkCount

Número de bloques de datos de cuerpo de entidad especificados en la matriz pEntityChunks . Este número no puede superar los 100. Si la respuesta no tiene ningún cuerpo de entidad, este miembro debe ser cero.

pEntityChunks

Matriz de estructuras de HTTP_DATA_CHUNK que especifican todos los bloques de datos que componen el cuerpo de entidad de la respuesta.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado http.h

Consulte también

Estructuras de la API de servidor HTTP versión 2.0

HTTP_DATA_CHUNK

HTTP_REQUEST

HTTP_RESPONSE

HTTP_RESPONSE_HEADERS

HTTP_RESPONSE_V2

HttpSendHttpResponse