Compartilhar via


estrutura HTTP_RESPONSE_V1 (http.h)

A estrutura HTTP_RESPONSE_V1 contém dados associados a uma resposta HTTP.

Não use HTTP_RESPONSE_V1 diretamente em seu código; use HTTP_RESPONSE para garantir que a versão adequada, com base no sistema operacional em que o código é compilado, seja usada.

Sintaxe

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;

Membros

Flags

Os sinalizadores de log opcionais alteram o comportamento de resposta padrão. Eles podem ser um dos valores HTTP_RESPONSE_FLAG .

Version

Este membro é ignorado; a resposta é sempre uma resposta HTTP/1.1.

StatusCode

Código status numérico que caracteriza o resultado da solicitação HTTP (por exemplo, 200 significando "OK" ou 404 significando "Não Encontrado"). Para obter mais informações e uma lista desses códigos, consulte a Seção 10 do RFC 2616.

Se uma solicitação for direcionada para uma URL reservada, mas não registrada, indicando que o aplicativo apropriado para lidar com ela não está em execução, a própria API do Servidor HTTP retornará uma resposta com status código 400, significando "Solicitação incorreta". Isso é transparente para o aplicativo. Um código 400 é preferencial aqui para 503 ("Servidor não disponível") porque este último é interpretado por alguns balanceadores de carga inteligentes como uma indicação de que o servidor está sobrecarregado.

ReasonLength

Tamanho, em bytes, da cadeia de caracteres apontada pelo membro pReason que não inclui o nulo de terminação. Pode ser zero.

pReason

Um ponteiro para uma cadeia de caracteres imprimível e terminada em nulo legível que caracteriza o resultado da solicitação HTTP (por exemplo, "OK" ou "Não Encontrado").

Headers

Uma estrutura HTTP_RESPONSE_HEADERS que contém os cabeçalhos usados nesta resposta.

EntityChunkCount

Vários blocos de dados do corpo da entidade especificados na matriz pEntityChunks . Esse número não pode exceder 100. Se a resposta não tiver nenhum corpo de entidade, esse membro deverá ser zero.

pEntityChunks

Uma matriz de estruturas HTTP_DATA_CHUNK que, juntas, especificam todos os blocos de dados que compõem o corpo da entidade da resposta.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho http.h

Confira também

Estruturas da API do Servidor HTTP versão 2.0

HTTP_DATA_CHUNK

HTTP_REQUEST

HTTP_RESPONSE

HTTP_RESPONSE_HEADERS

HTTP_RESPONSE_V2

HttpSendHttpResponse