Partager via

énumération HTTP_HEADER_ID (http.h)

  • Article

Le type d’énumération HTTP_HEADER_ID répertorie les en-têtes connus pour les requêtes et les réponses HTTP, et associe un index de tableau à chacun de ces en-têtes. Il est utilisé pour dimensionner et accéder aux membres du tableau KnownHeaders des structures HTTP_REQUEST_HEADERS et HTTP_RESPONSE_HEADERS .

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;

Constantes

 
HttpHeaderCacheControl
Valeur : 0
Permet de spécifier le comportement de mise en cache le long de la chaîne de requête ou de réponse, en remplaçant l’algorithme de mise en cache par défaut.
HttpHeaderConnection
Valeur : 1
Permet à l’expéditeur de spécifier les options souhaitées pour cette connexion particulière. Ils sont utilisés pour une seule connexion et ne doivent pas être communiqués par des proxys via d’autres connexions.
HttpHeaderDate
Valeur : 2
Date est un champ d’en-tête général qui indique l’heure d’envoi de la demande ou de la réponse.
HttpHeaderKeepAlive
Valeur : 3
Basé sur l’élément keepalive XML (voir RFC 2518, section 12.12.1, page 66) ; liste d’URI inclus dans KeepAlive
l’en-tête doit être « actif » une fois qu’ils ont été copiés
(déplacé) vers la destination.
HttpHeaderPragma
Valeur : 4
Permet d’inclure des directives facultatives spécifiques à l’implémentation qui peuvent s’appliquer à n’importe quel destinataire le long de la chaîne de demande/réponse.
HttpHeaderTrailer
Valeur : 5
Indique que les champs d’en-tête spécifiés sont présents dans la bande-annonce d’un message encodé avec un codage de transfert en bloc.
HttpHeaderTransferEncoding
Valeur : 6
Indique quelles transformations, le cas échéant, ont été appliquées au corps du message en transit.
HttpHeaderUpgrade
Valeur : 7
Permet au client de spécifier un ou plusieurs autres protocoles de communication qu’il préférerait utiliser si le serveur peut se conformer.
HttpHeaderVia
Valeur : 8
Le champ Via header indique le chemin emprunté par la demande.
HttpHeaderWarning
Valeur : 9
Il s’agit d’un en-tête de réponse qui contient le code d’avertissement à 3 chiffres ainsi que l’expression de motif.
HttpHeaderAllow
Valeur : 10
Listes l’ensemble de méthodes prises en charge par la ressource identifiée par l’URI de requête.
HttpHeaderContentLength
Valeur : 11
Taille du corps du message en octets décimaux.
HttpHeaderContentType
Valeur : 12
Type de média du corps du message.
HttpHeaderContentEncoding
Valeur : 13
Schéma d’encodage pour le corps du message.
HttpHeaderContentLanguage
Valeur : 14
Fournit le langage naturel de l’audience prévue.
HttpHeaderContentLocation
Valeur : 15
Emplacement de la ressource pour l’entité placée dans le message lorsque cette entité est accessible à partir d’un emplacement distinct de l’URI de la ressource demandée.
HttpHeaderContentMd5
Valeur : 16
Résumé MD5 du corps de l’entité utilisé pour fournir l’intégrité du message de bout en bout case activée (MIC) du corps de l’entité.
HttpHeaderContentRange
Valeur : 17
L’en-tête de plage de contenu est envoyé avec un corps d’entité partiel pour spécifier où, dans le corps d’entité complet, le corps partiel doit être appliqué.
HttpHeaderExpires
Valeur : 18
Date et heure après lesquelles le contenu du message expire.
HttpHeaderLastModified
Valeur : 19
Indique la date et l’heure auxquelles le serveur d’origine croit que la variante a été modifiée pour la dernière fois.
HttpHeaderAccept
Valeur : 20
Utilisé avec les méthodes INVITE, OPTIONS et REGISTER pour indiquer quels types de médias sont acceptables dans la réponse.
HttpHeaderAcceptCharset
Valeur : 21
Indique les jeux de caractères acceptables pour la réponse.
HttpHeaderAcceptEncoding
Valeur : 22
Encodages de contenu acceptables dans la réponse.
HttpHeaderAcceptLanguage
Valeur : 23
Utilisé par le client pour indiquer au serveur quelle langue il préférerait recevoir des expressions de motif, des descriptions de session ou des réponses status.
HttpHeaderAuthorization
Valeur : 24
L’agent utilisateur peut s’authentifier auprès d’un serveur en envoyant le champ d’en-tête de demande d’autorisation avec la demande. Le champ contient les informations d’identification du domaine que l’utilisateur demande.
HttpHeaderCookie
Valeur : 25
L’en-tête de demande de cookie contient les données utilisées pour maintenir l’état du client avec le serveur. Les données de cookie sont obtenues à partir d’une réponse envoyée avec HttpHeaderSetCookie.
HttpHeaderExpect
Valeur : 26
Indique les comportements de serveur spécifiques requis par le client.
HttpHeaderFrom
Valeur : 27
Le champ De l’en-tête spécifie l’initiateur du message de demande ou de réponse SIP.
HttpHeaderHost
Valeur : 28
Spécifie l’hôte Internet et le numéro de port de la ressource demandée. Cela est obtenu à partir de l’URI d’origine donné par l’utilisateur ou la ressource de référence.
HttpHeaderIfMatch
Valeur : 29
Le champ d’en-tête de requête If-Match est utilisé avec une méthode pour le rendre conditionnel. Un client qui a une ou plusieurs entités précédemment obtenues à partir de la ressource peut vérifier que l’une de ces entités est à jour en incluant une liste de leurs balises d’entité associées dans le champ d’en-tête If-Match.
HttpHeaderIfModifiedSince
Valeur : 30
Le champ d’en-tête de requête If-Modified-Since est utilisé avec une méthode pour le rendre conditionnel. Si la variante demandée n’a pas été modifiée depuis l’heure spécifiée dans ce champ, une entité n’est pas retournée à partir du serveur ; au lieu de cela, une réponse 304 (non modifiée) est retournée sans corps de message.
HttpHeaderIfNoneMatch
Valeur : 31
Le champ if-none-match request-header est utilisé avec une méthode à effectuer
il est conditionnel. Lorsqu’un client a obtenu une ou plusieurs entités à partir d’une ressource, il peut vérifier qu’aucune de ces entités n’est
current en incluant une liste des balises d’entité associées dans le
Champ d’en-tête If-None-Match. L’objectif de cette fonctionnalité est d’autoriser
mises à jour efficaces des informations mises en cache avec une quantité minimale de
surcharge de transaction et pour empêcher une méthode telle que PUT
de la modification par inadvertance d’une ressource existante lorsque le client
estime que la ressource n’existe pas.
HttpHeaderIfRange
Valeur : 32
Si un client a une copie partielle d’une entité dans son cache et souhaite
pour obtenir une copie à jour de l’ensemble de l’entité, il
peut utiliser l’en-tête If-Range. De manière informelle, sa signification est : « si l’entité est inchangée, envoyez
moi la ou les parties qui me manquent ; sinon, envoyez-moi tout le nouveau
entité. »
HttpHeaderIfUnmodifiedSince
Valeur : 33
Le champ If-Unmodified-Since request-header est utilisé avec une méthode pour
la rendre conditionnelle. Si la ressource demandée n’a pas été modifiée
depuis l’heure spécifiée dans ce champ, le serveur effectue le
opération demandée comme si l’en-tête If-Unmodified-Since n’était pas
présent, mais

si la ressource demandée a été modifiée,
le serveur retourne
erreur 412 (échec de la condition préalable).
HttpHeaderMaxForwards
Valeur : 34
Nombre maximal de proxys ou de passerelles pouvant transférer la demande.
HttpHeaderProxyAuthorization
Valeur : 35
Ce champ d’en-tête est utilisé par le client pour s’identifier avec un proxy.
HttpHeaderReferer
Valeur : 36
Permet au client de spécifier, pour l’avantage du serveur, l’adresse (URI) de la ressource à partir de laquelle l’URI de requête a été obtenu.
HttpHeaderRange
Valeur : 37
Permet à un client de demander une partie d’une entité au lieu de l’ensemble.
HttpHeaderTe
Valeur : 38
Ce champ d’en-tête contient le destinataire de la demande ou du message de réponse SIP.
HttpHeaderTranslate
Valeur : 39
Permet au client de spécifier s’il souhaite la représentation source ou l’interprétation par programmation du contenu demandé.
HttpHeaderUserAgent
Valeur : 40
Indique les codages de transfert d’extension que le client accepte dans la réponse et si le client accepte ou non les champs de bande-annonce dans un codage de transfert en bloc.
HttpHeaderRequestMaximum
Valeur : 41
Pas une valeur qui désigne réellement un en-tête ; au lieu de cela, elle est utilisée pour compter les en-têtes de requête énumérés.
HttpHeaderAcceptRanges
Valeur : 20
Permet au serveur d’indiquer son acceptation des demandes de plage pour une ressource.
HttpHeaderAge
Valeur : 21
Transmet l’estimation de l’expéditeur du temps écoulé depuis la génération de la réponse (ou de sa revalidation) sur le serveur d’origine.
HttpHeaderEtag
Valeur : 22
Fournit la valeur actuelle de la balise d’entité pour la variante demandée.
HttpHeaderLocation
Valeur : 23
Permet de rediriger le destinataire vers un emplacement autre que l’URI de requête pour l’achèvement de la demande ou l’identification d’une nouvelle ressource.
HttpHeaderProxyAuthenticate
Valeur : 24
Champ de réponse qui doit être inclus dans le cadre de la réponse 407. Le champ inclut le schéma d’authentification et les paramètres qui s’appliquent au proxy pour cet URI de requête.
HttpHeaderRetryAfter
Valeur : 25
Durée pendant laquelle le service est censé être indisponible pour le client demandeur.
HttpHeaderServer
Valeur : 26
Il s’agit d’un champ d’en-tête de réponse qui contient des informations sur le serveur qui gère la demande.
HttpHeaderSetCookie
Valeur : 27
L’en-tête de réponse set-cookie contient les données utilisées pour maintenir l’état du client dans les futures requêtes envoyées avec HttpHeaderCookie.
HttpHeaderVary
Valeur : 28
Indique l’ensemble des champs d’en-tête de requête qui déterminent entièrement, pendant que la réponse est à jour, si un cache est autorisé à utiliser la réponse pour répondre à une demande ultérieure sans revalidation.
HttpHeaderWwwAuthenticate
Valeur : 29
Le champ d’en-tête WWW_Authenticate contient les schémas d’authentification et les paramètres applicables à l’URI de requête.
HttpHeaderResponseMaximum
Valeur : 30
Pas une valeur qui désigne réellement un en-tête ; au lieu de cela, il est utilisé pour compter les en-têtes de réponse énumérés.
HttpHeaderMaximum
Valeur : 41
Pas une valeur qui désigne réellement un en-tête ; au lieu de cela, il est utilisé pour compter tous les en-têtes énumérés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête http.h

Voir aussi

HTTP_REQUEST_HEADERS

HTTP_RESPONSE_HEADERS