HTTP_HEADER_ID-Enumeration (http.h)

Der HTTP_HEADER_IDEnumerationstyp listet bekannte Header für HTTP-Anforderungen und -Antworten auf und ordnet jedem solchen Header einen Arrayindex zu. Es wird verwendet, um die Größe und den Zugriff auf die KnownHeaders-Arraymember der HTTP_REQUEST_HEADERS - und HTTP_RESPONSE_HEADERS-Strukturen zu erhalten.

Syntax

typedef enum _HTTP_HEADER_ID {
  HttpHeaderCacheControl = 0,
  HttpHeaderConnection = 1,
  HttpHeaderDate = 2,
  HttpHeaderKeepAlive = 3,
  HttpHeaderPragma = 4,
  HttpHeaderTrailer = 5,
  HttpHeaderTransferEncoding = 6,
  HttpHeaderUpgrade = 7,
  HttpHeaderVia = 8,
  HttpHeaderWarning = 9,
  HttpHeaderAllow = 10,
  HttpHeaderContentLength = 11,
  HttpHeaderContentType = 12,
  HttpHeaderContentEncoding = 13,
  HttpHeaderContentLanguage = 14,
  HttpHeaderContentLocation = 15,
  HttpHeaderContentMd5 = 16,
  HttpHeaderContentRange = 17,
  HttpHeaderExpires = 18,
  HttpHeaderLastModified = 19,
  HttpHeaderAccept = 20,
  HttpHeaderAcceptCharset = 21,
  HttpHeaderAcceptEncoding = 22,
  HttpHeaderAcceptLanguage = 23,
  HttpHeaderAuthorization = 24,
  HttpHeaderCookie = 25,
  HttpHeaderExpect = 26,
  HttpHeaderFrom = 27,
  HttpHeaderHost = 28,
  HttpHeaderIfMatch = 29,
  HttpHeaderIfModifiedSince = 30,
  HttpHeaderIfNoneMatch = 31,
  HttpHeaderIfRange = 32,
  HttpHeaderIfUnmodifiedSince = 33,
  HttpHeaderMaxForwards = 34,
  HttpHeaderProxyAuthorization = 35,
  HttpHeaderReferer = 36,
  HttpHeaderRange = 37,
  HttpHeaderTe = 38,
  HttpHeaderTranslate = 39,
  HttpHeaderUserAgent = 40,
  HttpHeaderRequestMaximum = 41,
  HttpHeaderAcceptRanges = 20,
  HttpHeaderAge = 21,
  HttpHeaderEtag = 22,
  HttpHeaderLocation = 23,
  HttpHeaderProxyAuthenticate = 24,
  HttpHeaderRetryAfter = 25,
  HttpHeaderServer = 26,
  HttpHeaderSetCookie = 27,
  HttpHeaderVary = 28,
  HttpHeaderWwwAuthenticate = 29,
  HttpHeaderResponseMaximum = 30,
  HttpHeaderMaximum = 41
} HTTP_HEADER_ID, *PHTTP_HEADER_ID;

Konstanten

HttpHeaderCacheControl Wert: 0 Wird verwendet, um das Zwischenspeicherungsverhalten entlang der Anforderungs- oder Antwortkette anzugeben, wobei der Standardcachealgorithmus überschrieben wird.
HttpHeaderConnection Wert: 1 Ermöglicht dem Absender, Optionen anzugeben, die für diese bestimmte Verbindung gewünscht sind. Diese werden nur für eine einzelne Verbindung verwendet und dürfen nicht von Proxys über weitere Verbindungen kommuniziert werden.
HttpHeaderDate Wert: 2 Das Datum ist ein allgemeines Kopfzeilenfeld, das die Uhrzeit angibt, zu der die Anforderung oder Antwort gesendet wurde.
HttpHeaderKeepAlive Wert: 3 Basierend auf dem keepalive XML-Element (siehe RFC 2518, Abschnitt 12.12.1, Seite 66); eine Liste der in KeepAlive enthaltenen URIs Der Header muss nach dem Kopieren "live" sein. (verschoben) an das Ziel.
HttpHeaderPragma Wert: 4 Wird verwendet, um optionale, implementierungsspezifische Anweisungen einzuschließen, die für jeden Empfänger entlang der Anforderungs-/Antwortkette gelten können.
HttpHeaderTrailer Wert: 5 Gibt an, dass angegebene Headerfelder im Trailer einer Nachricht vorhanden sind, die mit chunked transfer-coding codiert ist.
HttpHeaderTransferEncoding Wert: 6 Gibt an, welche Transformationen bei der Übertragung auf den Nachrichtentext angewendet wurden, falls vorhanden.
HttpHeaderUpgrade Wert: 7 Ermöglicht dem Client, ein oder mehrere andere Kommunikationsprotokolle anzugeben, die er lieber verwenden würde, wenn der Server die Anforderungen erfüllen kann.
HttpHeaderVia Wert: 8 Das Feld Via-Header gibt den Pfad an, den die Anforderung genommen hat.
HttpHeaderWarning Wert: 9 Dies ist ein Antwortheader, der den 3-stelligen Warncode zusammen mit dem Grundbegriff enthält.
HttpHeaderAllow Wert: 10 Listen den Satz von Methoden, die von der vom Anforderungs-URI identifizierten Ressource unterstützt werden.
HttpHeaderContentLength Wert: 11 Die Größe des Nachrichtentexts in Dezimalbytes.
HttpHeaderContentType Wert: 12 Der Medientyp des Nachrichtentexts.
HttpHeaderContentEncoding Wert: 13 Das Codierungsschema für den Nachrichtentext.
HttpHeaderContentLanguage Wert: 14 Stellt die natürliche Sprache der vorgesehenen Zielgruppe bereit.
HttpHeaderContentLocation Wert: 15 Speicherort der Ressource für die In der Nachricht eingeschlossene Entität, wenn auf diese Entität von einem vom URI der angeforderten Ressource getrennten Speicherort zugegriffen werden kann.
HttpHeaderContentMd5 Wert: 16 Ein MD5-Digest des Entitätskörpers, der verwendet wird, um eine End-to-End-Message Integrity Check (MIC) des Entitätstexts bereitzustellen.
HttpHeaderContentRange Wert: 17 Der Inhaltsbereichsheader wird mit einem partiellen Entitätstext gesendet, um anzugeben, wo im vollständigen Entitätstext der Teiltext angewendet werden soll.
HttpHeaderExpires Wert: 18 Das Datum und die Uhrzeit, nach dem der Nachrichteninhalt abläuft.
HttpHeaderLastModified Wert: 19 Gibt das Datum und die Uhrzeit an, zu denen der Ursprungsserver glaubt, dass die Variante zuletzt geändert wurde.
HttpHeaderAccept Wert: 20 Wird mit den METHODEN INVITE, OPTIONS und REGISTER verwendet, um anzugeben, welche Medientypen in der Antwort akzeptabel sind.
HttpHeaderAcceptCharset Wert: 21 Gibt die Zeichensätze an, die für die Antwort akzeptabel sind.
HttpHeaderAcceptEncoding Wert: 22 Die Inhaltscodierungen, die in der Antwort akzeptabel sind.
HttpHeaderAcceptLanguage Wert: 23 Wird vom Client verwendet, um dem Server anzugeben, welche Sprache er bevorzugen würde, um Begründungsausdrücke, Sitzungsbeschreibungen oder status Antworten zu erhalten.
HttpHeaderAuthorization Wert: 24 Der Benutzer-Agent kann sich bei einem Server authentifizieren, indem er das Feld Autorisierungsanforderungsheader mit der Anforderung sendet. Das Feld enthält die Anmeldeinformationen für die Domäne, die der Benutzer anfordert.
HttpHeaderCookie Wert: 25 Der Cookieanforderungsheader enthält Daten, die verwendet werden, um den Clientstatus mit dem Server aufrechtzuerhalten. Cookiedaten werden aus einer Antwort abgerufen, die mit HttpHeaderSetCookie gesendet wurde.
HttpHeaderExpect Wert: 26 Gibt die spezifischen Serververhalten an, die für den Client erforderlich sind.
HttpHeaderFrom Wert: 27 Das Feld From-Header gibt den Initiator der SIP-Anforderung oder Antwortnachricht an.
HttpHeaderHost Wert: 28 Gibt den Internethost und die Portnummer der angeforderten Ressource an. Dies wird aus dem ursprünglichen URI abgerufen, der vom Benutzer oder der verweisenden Ressource angegeben wurde.
HttpHeaderIfMatch Wert: 29 Das If-Match Anforderungsheaderfeld wird mit einer -Methode verwendet, um es bedingt zu machen. Ein Client, der über mindestens eine Entität verfügt, die zuvor aus der Ressource abgerufen wurde, kann überprüfen, ob eine dieser Entitäten aktuell ist, indem er eine Liste der zugeordneten Entitätstags in das Feld If-Match Header einfügt.
HttpHeaderIfModifiedSince Wert: 30 Das Feld If-Modified-Since-Anforderungsheader wird mit einer Methode verwendet, um es bedingt zu machen. Wenn die angeforderte Variante seit der in diesem Feld angegebenen Zeit nicht geändert wurde, wird keine Entität vom Server zurückgegeben. stattdessen wird eine Antwort 304 (nicht geändert) ohne Nachrichtentext zurückgegeben.
HttpHeaderIfNoneMatch Wert: 31 Das Anforderungsheaderfeld If-None-Match wird mit einer Methode verwendet, die zu erstellen ist. bedingt. Wenn ein Client eine oder mehrere Entitäten aus einer Ressource abgerufen hat, kann er überprüfen, ob es sich um keine dieser Entitäten handelt. current, indem eine Liste der zugeordneten Entitätstags in die If-None-Match-Headerfeld. Der Zweck dieses Features besteht darin, zuzulassen. effiziente Updates von zwischengespeicherten Informationen mit einer Mindestmenge an Transaktionsmehraufwand und zum Verhindern einer Methode wie PUT vom versehentlichen Ändern einer vorhandenen Ressource beim Client ist der Ansicht, dass die Ressource nicht vorhanden ist.
HttpHeaderIfRange Wert: 32 Wenn ein Client eine Teilkopie einer Entität im Cache hat und wünscht um eine aktuelle Kopie der gesamten Entität zu erhalten, kann den If-Range-Header verwenden. Informell ist seine Bedeutung, "wenn die Entität unverändert ist, senden mir fehlen die Teile, die mir fehlen; andernfalls senden Sie mir die gesamte neue entität."
HttpHeaderIfUnmodifiedSince Wert: 33 Das If-Unmodified-Since-Anforderungsheaderfeld wird mit einer Methode verwendet, um Stellen Sie es bedingt fest. Wenn die angeforderte Ressource nicht geändert wurde seit der in diesem Feld angegebenen Zeit führt der Server die Angeforderter Vorgang, als ob der If-Unmodified-Since-Header nicht wäre vorhanden, aber , wenn die angeforderte Ressource geändert wurde, Der Server gibt zurück ein Fehler 412 (Vorbedingung fehlgeschlagen).
HttpHeaderMaxForwards Wert: 34 Die maximale Anzahl von Proxys oder Gateways, die die Anforderung weiterleiten können.
HttpHeaderProxyAuthorization Wert: 35 Dieses Headerfeld wird vom Client verwendet, um sich mit einem Proxy zu identifizieren.
HttpHeaderReferer Wert: 36 Ermöglicht dem Client, zum Nutzen des Servers die Adresse (URI) der Ressource anzugeben, von der der Anforderungs-URI abgerufen wurde.
HttpHeaderRange Wert: 37 Ermöglicht es einem Client, einen Teil einer Entität anstelle des Ganzen anzufordern.
HttpHeaderTe Wert: 38 Dieses Headerfeld enthält den Empfänger der SIP-Anforderung oder -Antwortnachricht.
HttpHeaderTranslate Wert: 39 Ermöglicht dem Client, anzugeben, ob er die Quelldarstellung oder programmgesteuerte Interpretation des angeforderten Inhalts wünscht.
HttpHeaderUserAgent Wert: 40 Gibt an, welche Erweiterungsübertragungscodierungen der Client in der Antwort akzeptiert und ob der Client Trailerfelder in einer blockierten Transfercodierung akzeptiert oder nicht.
HttpHeaderRequestMaximum Wert: 41 Kein Wert, der tatsächlich einen Header angibt; stattdessen wird sie verwendet, um die aufgezählten Anforderungsheader zu zählen.
HttpHeaderAcceptRanges Wert: 20 Ermöglicht dem Server, die Annahme von Bereichsanforderungen für eine Ressource anzugeben.
HttpHeaderAge Wert: 21 Gibt die Schätzung des Absenders der Zeitspanne an, seit die Antwort (oder ihre erneute Überprüfung) auf dem Ursprungsserver generiert wurde.
HttpHeaderEtag Wert: 22 Stellt den aktuellen Wert des Entitätstags für die angeforderte Variante bereit.
HttpHeaderLocation Wert: 23 Wird verwendet, um den Empfänger an einen anderen Speicherort als den Anforderungs-URI für den Abschluss der Anforderung oder die Identifizierung einer neuen Ressource umzuleiten.
HttpHeaderProxyAuthenticate Wert: 24 Das Antwortfeld, das als Teil der Antwort 407 enthalten sein muss. Das Feld enthält das Authentifizierungsschema und die Parameter, die für den Proxy für diesen Anforderungs-URI gelten.
HttpHeaderRetryAfter Wert: 25 Die Dauer, für die der Dienst für den anfordernden Client voraussichtlich nicht verfügbar ist.
HttpHeaderServer Wert: 26 Dies ist ein Antwortheaderfeld, das Informationen zu dem Server enthält, der die Anforderung verarbeitet.
HttpHeaderSetCookie Wert: 27 Der Set-Cookie-Antwortheader enthält Daten, die verwendet werden, um den Clientstatus in zukünftigen Anforderungen beizubehalten, die mit HttpHeaderCookie gesendet werden.
HttpHeaderVary Wert: 28 Gibt den Satz von Anforderungsheaderfeldern an, der vollständig bestimmt, während die Antwort frisch ist, ob ein Cache die Antwort verwenden darf, um auf eine nachfolgende Anforderung ohne erneute Überprüfung zu antworten.
HttpHeaderWwwAuthenticate Wert: 29 Das Feld WWW_Authenticate-Header enthält die Authentifizierungsschemas und Parameter, die für den Anforderungs-URI gelten.
HttpHeaderResponseMaximum Wert: 30 Kein Wert, der tatsächlich einen Header angibt; stattdessen wird sie verwendet, um die aufgezählten Antwortheader zu zählen.
HttpHeaderMaximum Wert: 41 Kein Wert, der tatsächlich einen Header angibt; stattdessen wird sie verwendet, um alle aufgezählten Header zu zählen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	http.h

Weitere Informationen

HTTP_REQUEST_HEADERS

HTTP_RESPONSE_HEADERS