struttura HTTP_RESPONSE_V1 (http.h)

Articolo
08/24/2023

La struttura HTTP_RESPONSE_V1 contiene dati associati a una risposta HTTP.

Non usare HTTP_RESPONSE_V1 direttamente nel codice; usare HTTP_RESPONSE invece per assicurarsi che venga usata la versione corretta in base al sistema operativo in cui viene compilato il codice.

Sintassi

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

I flag di registrazione facoltativi modificano il comportamento di risposta predefinito. Questi valori possono essere uno dei valori di HTTP_RESPONSE_FLAG .

Version

Questo membro viene ignorato; la risposta è sempre una risposta HTTP/1.1.

StatusCode

Codice di stato numerico che caratterizza il risultato della richiesta HTTP (ad esempio, 200 firmando "OK" o 404 firmando "Not Found"). Per altre informazioni e un elenco di questi codici, vedere Sezione 10 di RFC 2616.

Se una richiesta viene indirizzata a un URL riservato ma non registrato, che indica che l'applicazione appropriata per gestirla non è in esecuzione, l'API server HTTP restituisce una risposta con codice di stato 400, firmando "Richiesta non valida". Questo è trasparente per l'applicazione. Un codice 400 è preferibile qui a 503 ("Server non disponibile") perché quest'ultimo viene interpretato da alcuni servizi di bilanciamento del carico intelligente come indicazione che il server è in overload.

ReasonLength

Dimensioni, in byte, della stringa a cui punta il membro pReason non inclusa la terminazione null. Può essere zero.

pReason

Puntatore a una stringa leggibile, con terminazione null di caratteri stampabili che caratterizza il risultato della richiesta HTTP, ad esempio "OK" o "Not Found").

Headers

Struttura HTTP_RESPONSE_HEADERS contenente le intestazioni usate in questa risposta.

EntityChunkCount

Numero di blocchi di dati del corpo dell'entità specificati nella matrice pEntityChunks . Questo numero non può superare i 100. Se la risposta non ha alcun corpo dell'entità, questo membro deve essere zero.

pEntityChunks

Matrice di strutture HTTP_DATA_CHUNK che specificano insieme tutti i blocchi di dati che costituiscono il corpo dell'entità della risposta.