HTTP_HEADER_ID-Enumeration (http.h)

  • Artikel

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