HTTP_RESPONSE_V1-Struktur (http.h)

Artikel
08/24/2023

Die HTTP_RESPONSE_V1-Struktur enthält Daten, die einer HTTP-Antwort zugeordnet sind.

Verwenden Sie HTTP_RESPONSE_V1 nicht direkt im Code. Verwenden Sie stattdessen HTTP_RESPONSE , um sicherzustellen, dass die richtige Version basierend auf dem Betriebssystem verwendet wird, unter dem der Code kompiliert wird.

Syntax

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

Die optionalen Protokollierungsflags ändern das Standardantwortverhalten. Dies kann einer der HTTP_RESPONSE_FLAG Werte sein.

Version

Dieses Element wird ignoriert. die Antwort ist immer eine HTTP/1.1-Antwort.

StatusCode

Numerische status Code, der das Ergebnis der HTTP-Anforderung charakterisiert (z. B. 200, das "OK" bedeutet, oder 404 für "Nicht gefunden"). Weitere Informationen und eine Liste dieser Codes finden Sie in Abschnitt 10 von RFC 2616.

Wenn eine Anforderung an eine url weitergeleitet wird, die reserviert, aber nicht registriert ist und angibt, dass die entsprechende Anwendung, die sie behandeln soll, nicht ausgeführt wird, gibt die HTTP-Server-API selbst eine Antwort mit status Code 400 zurück, die "Ungültige Anforderung" bedeutet. Dies ist für die Anwendung transparent. Code 400 wird hier gegenüber 503 ("Server nicht verfügbar") bevorzugt, da letzteres von einigen intelligenten Lastenausgleichsmodulen als Hinweis darauf interpretiert wird, dass der Server überlastet ist.

ReasonLength

Größe der Zeichenfolge in Bytes, auf die vom pReason-Member verwiesen wird, ohne dass der beendende NULL-Wert enthalten ist. Kann null sein.

pReason

Ein Zeiger auf eine für Menschen lesbare, null-beendete Zeichenfolge druckbarer Zeichen, die das Ergebnis der HTTP-Anforderung charakterisiert (z. B. "OK" oder "Nicht gefunden").

Headers

Eine HTTP_RESPONSE_HEADERS-Struktur , die die in dieser Antwort verwendeten Header enthält.

EntityChunkCount

Eine Reihe von Entitätskörperdatenblöcken, die im pEntityChunks-Array angegeben sind. Diese Zahl darf 100 nicht überschreiten. Wenn die Antwort keinen Entitätstext aufweist, muss dieser Member 0 sein.

pEntityChunks

Ein Array von HTTP_DATA_CHUNK Strukturen, die zusammen alle Datenblöcke angeben, aus denen der Entitätstext der Antwort besteht.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	http.h

Weitere Informationen

HTTP-Server-API, Version 2.0-Strukturen

HTTP_DATA_CHUNK

HTTP_REQUEST

HTTP_RESPONSE

HTTP_RESPONSE_HEADERS

HTTP_RESPONSE_V2

HttpSendHttpResponse