Indicateurs d’informations de requête (Winhttp.h)
Ces attributs et modificateurs sont utilisés par WinHttpQueryHeaders.
Les indicateurs d’attribut sont utilisés par WinHttpQueryHeaders pour indiquer les informations à récupérer. La plupart des indicateurs d’attribut sont mappés directement à un en-tête HTTP spécifique. Il existe également des indicateurs spéciaux, tels que WINHTTP_QUERY_RAW_HEADERS, qui ne sont pas liés à un en-tête spécifique.
-
WINHTTP_QUERY_ACCEPT
-
-
Récupère les types de média acceptables pour la réponse.
-
-
WINHTTP_QUERY_ACCEPT_CHARSET
-
-
Récupère les jeux de caractères acceptables pour la réponse.
-
-
WINHTTP_QUERY_ACCEPT_ENCODING
-
-
Récupère les valeurs de codage de contenu acceptables pour la réponse.
-
-
WINHTTP_QUERY_ACCEPT_LANGUAGE
-
-
Récupère les langues naturelles acceptables pour la réponse.
-
-
WINHTTP_QUERY_ACCEPT_RANGES
-
-
Récupère les types de demandes de plage qui sont acceptés pour une ressource.
-
-
WINHTTP_QUERY_AGE
-
-
Récupère le champ Age response-header, qui contient l’estimation de l’expéditeur du temps écoulé depuis la génération de la réponse sur le serveur d’origine.
-
-
WINHTTP_QUERY_ALLOW
-
-
Reçoit les verbes HTTP pris en charge par le serveur.
-
-
WINHTTP_QUERY_AUTHENTICATION_INFO
-
-
Récupère l’en-tête Authentication-Info.
-
-
WINHTTP_QUERY_AUTHORIZATION
-
-
Récupère les informations d’identification d’autorisation utilisées pour une demande.
-
-
WINHTTP_QUERY_CACHE_CONTROL
-
-
Récupère les directives de contrôle de cache.
-
-
WINHTTP_QUERY_CONNECTION
-
-
Récupère toutes les options spécifiées pour une connexion particulière et ne doivent pas être communiquées par des proxys via d’autres connexions.
-
-
WINHTTP_QUERY_CONTENT_BASE
-
-
Récupère l’URI (Uniform Resource Identifier) de base pour résoudre les URL relatives au sein de l’entité.
-
-
WINHTTP_QUERY_CONTENT_DESCRIPTION
-
-
Obsolète. Géré pour la compatibilité des applications héritées.
-
-
WINHTTP_QUERY_CONTENT_DISPOSITION
-
-
Obsolète. Géré pour la compatibilité des applications héritées.
-
-
WINHTTP_QUERY_CONTENT_ENCODING
-
-
Récupère le codage de contenu supplémentaire qui a été appliqué à l’ensemble de la ressource.
-
-
WINHTTP_QUERY_CONTENT_ID
-
-
Récupère l’identification du contenu.
-
-
WINHTTP_QUERY_CONTENT_LANGUAGE
-
-
Récupère la langue dans laquelle le contenu est écrit.
-
-
WINHTTP_QUERY_CONTENT_LENGTH
-
-
Récupère la taille de la ressource, en octets.
-
-
WINHTTP_QUERY_CONTENT_LOCATION
-
-
Récupère l’emplacement de ressource pour l’entité placée dans le message.
-
-
WINHTTP_QUERY_CONTENT_MD5
-
-
Récupère un condensé MD5 du corps de l’entité dans le but de fournir une vérification de l’intégrité des messages de bout en bout pour le corps de l’entité. Pour plus d’informations, consultez RFC 1864.
-
-
WINHTTP_QUERY_CONTENT_RANGE
-
-
Récupère l’emplacement dans le corps complet de l’entité où le corps d’entité partiel doit être inséré et la taille totale du corps d’entité complet.
-
-
WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING
-
-
Récupère une transformation d’encodage applicable à un corps d’entité. Il est possible qu’il ait déjà été appliqué, qu’il soit nécessaire de l’appliquer ou qu’il soit éventuellement applicable.
-
-
WINHTTP_QUERY_CONTENT_TYPE
-
-
Reçoit le type de contenu de la ressource, tel que texte ou html.
-
-
WINHTTP_QUERY_COOKIE
-
-
Récupère tous les cookies associés à la demande.
-
-
WINHTTP_QUERY_COST
-
-
Non pris en charge.
-
-
WINHTTP_QUERY_CUSTOM
-
-
Amène WinHttpQueryHeaders à rechercher le nom d’en-tête spécifié dans le paramètre pwszName et à stocker les informations d’en-tête dans lpBuffer. Une application peut utiliser WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT pour limiter la durée maximale pendant laquelle cette requête attend que tous les en-têtes soient reçus.
-
-
WINHTTP_QUERY_DATE
-
-
Reçoit la date et l’heure auxquelles le message a été généré.
-
-
WINHTTP_QUERY_DERIVED_FROM
-
-
Non pris en charge.
-
-
WINHTTP_QUERY_ETAG
-
-
Récupère la balise d’entité pour l’entité associée.
-
-
WINHTTP_QUERY_EXPECT
-
-
Récupère l’en-tête Expect, qui indique si l’application cliente doit attendre des réponses de 100 séries.
-
-
WINHTTP_QUERY_EXPIRES
-
-
Reçoit la date et l’heure après lesquelles la ressource doit être considérée comme obsolète.
-
-
WINHTTP_QUERY_FORWARDED
-
-
Obsolète. Géré pour la compatibilité des applications héritées.
-
-
WINHTTP_QUERY_FROM
-
-
Récupère l’adresse de messagerie de l’utilisateur qui contrôle l’agent utilisateur demandeur si l’en-tête From est indiqué.
-
-
WINHTTP_QUERY_HOST
-
-
Récupère l’hôte Internet et le numéro de port de la ressource demandée.
-
-
WINHTTP_QUERY_IF_MATCH
-
-
Récupère le contenu du champ If-Match request-header.
-
-
WINHTTP_QUERY_IF_MODIFIED_SINCE
-
-
Récupère le contenu de l’en-tête If-Modified-Since.
-
-
WINHTTP_QUERY_IF_NONE_MATCH
-
-
Récupère le contenu du champ If-None-Match request-header.
-
-
WINHTTP_QUERY_IF_RANGE
-
-
Récupère le contenu du champ If-Range request-header. Cet en-tête permet à l’application cliente de vérifier si l’entité liée à une copie partielle de l’entité dans le cache de l’application cliente n’a pas été mise à jour. Si l’entité n’a pas été mise à jour, envoyez les parties manquantes de l’application cliente. Si l’entité a été mise à jour, envoyez l’entité entière mise à jour.
-
-
WINHTTP_QUERY_IF_UNMODIFIED_SINCE
-
-
Récupère le contenu du champ If-Unmodified-Since request-header.
-
-
WINHTTP_QUERY_LINK
-
-
Obsolète. Géré pour la compatibilité des applications héritées.
-
-
WINHTTP_QUERY_LAST_MODIFIED
-
-
Reçoit la date et l’heure de la dernière modification de la ressource. La date et l’heure sont déterminées par le serveur.
-
-
WINHTTP_QUERY_LOCATION
-
-
Récupère l’URI absolu utilisé dans un en-tête response-location.
-
-
WINHTTP_QUERY_MAX
-
-
Indique la valeur maximale d’une valeur WINHTTP_QUERY_*. Pas un indicateur de requête.
-
-
WINHTTP_QUERY_MAX_FORWARDS
-
-
Récupère le nombre de proxys ou de passerelles qui peuvent transférer la demande au serveur entrant suivant.
-
-
WINHTTP_QUERY_MESSAGE_ID
-
-
Non pris en charge.
-
-
WINHTTP_QUERY_MIME_VERSION
-
-
Reçoit la version du protocole MIME (Multipurpose Internet Mail Extensions) utilisé pour construire le message.
-
-
WINHTTP_QUERY_ORIG_URI
-
-
Obsolète. Géré pour la compatibilité des applications héritées.
-
-
WINHTTP_QUERY_PRAGMA
-
-
Reçoit les directives spécifiques à l’implémentation qui peuvent s’appliquer à n’importe quel destinataire le long de la chaîne de demande/réponse.
-
-
WINHTTP_QUERY_PROXY_AUTHENTICATE
-
-
Récupère le schéma d’authentification et le domaine retournés par le proxy.
-
-
WINHTTP_QUERY_PROXY_AUTHORIZATION
-
-
Récupère l’en-tête utilisé pour identifier l’utilisateur auprès d’un proxy qui nécessite une authentification. Cet en-tête ne peut être récupéré qu’avant l’envoi de la demande au serveur.
-
-
WINHTTP_QUERY_PROXY_CONNECTION
-
-
Récupère l’en-tête Proxy-Connection.
-
-
WINHTTP_QUERY_PROXY_SUPPORT
-
-
Récupère l’en-tête Proxy-Support.
-
-
WINHTTP_QUERY_PUBLIC
-
-
Reçoit les verbes HTTP disponibles sur ce serveur.
-
-
WINHTTP_QUERY_RANGE
-
-
Récupère la plage d’octets d’une entité.
-
-
WINHTTP_QUERY_RAW_HEADERS
-
-
Reçoit tous les en-têtes retournés par le serveur. Chaque en-tête est terminé par « \0 ». Un « \0 » supplémentaire met fin à la liste des en-têtes.
-
-
WINHTTP_QUERY_RAW_HEADERS_CRLF
-
-
Reçoit tous les en-têtes retournés par le serveur. Chaque en-tête est séparé par une séquence de retour chariot/flux de ligne (CR/LF).
-
-
WINHTTP_QUERY_REFERER
-
-
Reçoit l’URI de la ressource où l’URI demandé a été obtenu.
-
-
WINHTTP_QUERY_REFRESH
-
-
Obsolète. Géré pour la compatibilité des applications héritées.
-
-
WINHTTP_QUERY_REQUEST_METHOD
-
-
Reçoit le verbe HTTP utilisé dans la requête, généralement GET ou POST.
-
-
WINHTTP_QUERY_RETRY_AFTER
-
-
Récupère la durée pendant laquelle le service est censé être indisponible.
-
-
WINHTTP_QUERY_SERVER
-
-
Récupère des informations sur le logiciel utilisé par le serveur d’origine pour gérer la demande.
-
-
WINHTTP_QUERY_SET_COOKIE
-
-
Reçoit la valeur du jeu de cookies pour la demande.
-
-
WINHTTP_QUERY_STATUS_CODE
-
-
Reçoit le code d’état retourné par le serveur. Pour obtenir la liste des valeurs possibles, consultez Codes d’état HTTP.
-
-
WINHTTP_QUERY_STATUS_TEXT
-
-
Reçoit le texte supplémentaire retourné par le serveur sur la ligne de réponse.
-
-
WINHTTP_QUERY_TITLE
-
-
Obsolète. Géré pour la compatibilité des applications héritées.
-
-
WINHTTP_QUERY_TRANSFER_ENCODING
-
-
Récupère le type de transformation qui a été appliqué au corps du message afin qu’il puisse être transféré en toute sécurité entre l’expéditeur et le destinataire.
-
-
WINHTTP_QUERY_UNLESS_MODIFIED_SINCE
-
-
Récupère l’en-tête Unless-Modified-Since.
-
-
WINHTTP_QUERY_UPGRADE
-
-
Récupère les protocoles de communication supplémentaires pris en charge par le serveur.
-
-
WINHTTP_QUERY_URI
-
-
Reçoit tout ou partie de l’URI par lequel la ressource Request-URI peut être identifiée.
-
-
WINHTTP_QUERY_USER_AGENT
-
-
Récupère des informations sur l’agent utilisateur qui a effectué la demande.
-
-
WINHTTP_QUERY_VARY
-
-
Récupère l’en-tête qui indique que l’entité a été sélectionnée à partir d’un certain nombre de représentations disponibles de la réponse à l’aide d’une négociation pilotée par le serveur.
-
-
WINHTTP_QUERY_VERSION
-
-
Récupère la version HTTP présente dans la ligne d’état.
-
-
WINHTTP_QUERY_VIA
-
-
Récupère les protocoles intermédiaires et les destinataires entre l’agent utilisateur et le serveur sur les demandes, et entre le serveur d’origine et le client sur les réponses.
-
-
WINHTTP_QUERY_WARNING
-
-
Récupère des informations supplémentaires sur l’état d’une réponse qui peuvent ne pas être reflétées par le code d’état de la réponse.
-
-
WINHTTP_QUERY_WWW_AUTHENTICATE
-
-
Récupère le schéma d’authentification et le domaine retournés par le serveur.
-
Les indicateurs de modificateur sont utilisés conjointement avec un indicateur d’attribut pour modifier la demande. Les indicateurs de modificateur modifient le format des données retournées ou indiquent où la fonction WinHttpQueryHeaders doit rechercher les informations.
-
WINHTTP_QUERY_FLAG_NUMBER
-
-
Retourne les données sous forme de nombre 32 bits pour les en-têtes dont la valeur est un nombre, tel que le code d’état.
-
-
WINHTTP_QUERY_FLAG_REQUEST_HEADERS
-
-
Les requêtes demandent uniquement des en-têtes.
-
-
WINHTTP_QUERY_FLAG_SYSTEMTIME
-
-
Retourne la valeur d’en-tête sous forme de structure SYSTEMTIME , qui ne nécessite pas que l’application analyse les données. Utilisez pour les en-têtes dont la valeur est une chaîne de date/heure, telle que « Last-Modified-Time ».
-
WINHTTP_QUERY_FLAG_TRAILERS
-
Introduit dans Windows 11, version 21H2 (10.0 ; Build 22000). Requêtes bandes-annonces de réponse. Avant d’interroger les bandes-annonces de réponse, vous devez appeler WinHttpReadData jusqu’à ce qu’il retourne 0 octet lu.
WINHTTP_QUERY_FLAG_WIRE_ENCODING
-
Introduit dans Windows 11, version 21H2 (10.0 ; Build 22000). Par défaut, WinHttpQueryHeaders effectue une conversion Unicode avant de renvoyer l’en-tête interrogé. Si cet indicateur est défini, WinHttp retourne l’en-tête à l’appelant sans effectuer cette conversion.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement] |
| En-tête |
|