é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