énumération HTTP_HEADER_ID (http.h)

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

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2023-08-24