HTTP_RESPONSE_V1-Struktur (http.h)
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 |