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 directement mappés à un en-tête HTTP spécifique. Il existe également des indicateurs spéciaux, tels que _ _ les en-têtes de requête WinHTTP bruts _ , qui ne sont pas associés à un en-tête spécifique.

acceptation de la _ requête WinHTTP _

Récupère les types de médias acceptables pour la réponse.

jeu de caractères d' _ acceptation de requête WinHTTP _ _

Récupère les jeux de caractères acceptables pour la réponse.

encodage d' _ acceptation de requête WinHTTP _ _

Récupère les valeurs de codage de contenu acceptables pour la réponse.

langue d’acceptation de la _ requête WinHTTP _ _

Récupère les langages naturels acceptables pour la réponse.

_plages d' _ acceptation des requêtes WinHTTP _

Récupère les types des demandes de plage acceptées pour une ressource.

_âge des requêtes WinHTTP _

Récupère le champ d’en-tête de réponse d’âge, qui contient l’estimation de la durée de l’expéditeur depuis la génération de la réponse au niveau du serveur d’origine.

autorisation de la _ requête WinHTTP _

Reçoit les verbes HTTP pris en charge par le serveur.

_ _ informations d’authentification de la requête WinHTTP _

Récupère l’en-tête de Authentication-Info.

_autorisation de requête WinHTTP _

Récupère les informations d’identification utilisées pour une demande.

_ _ contrôle du cache des requêtes WinHTTP _

Récupère les directives de contrôle de cache.

connexion à la _ requête WinHTTP _

Récupère toutes les options spécifiées pour une connexion particulière et ne doit pas être communiquée par les proxys sur des connexions supplémentaires.

_base de _ contenu de requête WinHTTP _

Récupère le Uniform Resource Identifier de base (URI) pour résoudre des URL relatives dans l’entité.

Description du contenu de la _ requête WinHTTP _ _

Obsolète. Conservé pour la compatibilité des applications héritées.

DISPOSITION du contenu de la _ requête WinHTTP _ _

Obsolète. Conservé pour la compatibilité des applications héritées.

encodage du contenu de la _ requête WinHTTP _ _

Récupère le codage de contenu supplémentaire qui a été appliqué à l’ensemble de la ressource.

ID de contenu de la _ requête WinHTTP _ _

Récupère l’identification du contenu.

langue de contenu de la _ requête WinHTTP _ _

Récupère la langue dans laquelle le contenu est écrit.

longueur du contenu de la _ requête WinHTTP _ _

Récupère la taille de la ressource, en octets.

emplacement du contenu de la _ requête WinHTTP _ _

Récupère l’emplacement de la ressource de l’entité incluse dans le message.

MD5 du contenu de la _ requête WinHTTP _ _

Récupère un condensé MD5 du corps d’entité afin 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 la RFC 1864.

plage de contenu de la _ requête WinHTTP _ _

Récupère l’emplacement dans le corps de l’entité complète où le corps de l’entité partielle doit être inséré et la taille totale du corps de l’entité complète.

encodage de transfert de contenu de _ requête WinHTTP _ _ _

Récupère une transformation d’encodage applicable à un corps d’entité. Il est possible qu’il ait déjà été appliqué, qu’il doive être appliqué ou éventuellement applicable.

TYPE de contenu de la _ requête WinHTTP _ _

Reçoit le type de contenu de la ressource, tel que texte ou html.

_cookie de requête WinHTTP _

Récupère tous les cookies associés à la requête.

_coût des requêtes WinHTTP _

Non pris en charge.

_requête WinHTTP _ personnalisée

Fait en sorte que WinHttpQueryHeaders recherche le nom d’en-tête spécifié dans le paramètre pwszName et stocke les informations d’en-tête dans lpBuffer. Une application peut utiliser l' _ option WinHTTP _ recevoir le _ _ délai de réponse pour limiter la durée maximale pendant laquelle cette requête attend que tous les en-têtes soient reçus.

Date de la _ requête WinHTTP _

Reçoit la date et l’heure d’origine du message.

_requête WinHTTP _ dérivée _ de

Non pris en charge.

_ETag de requête WinHTTP _

Récupère la balise d’entité de l’entité associée.

_requête WinHTTP _ attendue

Récupère l’en-tête Expect, qui indique si l’application cliente doit attendre des réponses de série 100.

expiration de la _ requête WinHTTP _

Reçoit la date et l’heure après lesquelles la ressource doit être considérée comme obsolète.

_requête WinHTTP _ transférée

Obsolète. Conservé pour la compatibilité des applications héritées.

_requête WinHTTP _ à partir de

Récupère l’adresse de messagerie de l’utilisateur qui contrôle l' agent utilisateur demandeur si l’en-tête from est donné.

_hôte de requête WinHTTP _

Récupère l’hôte Internet et le numéro de port de la ressource demandée.

_requête WinHTTP _ si _ correspondance

Récupère le contenu du champ d’en-tête de demande If-Match.

_requête WinHTTP _ si _ modifiée _ depuis

Récupère le contenu de l’en-tête If-Modified-Since.

_requête WinHTTP _ si _ aucune ne _ correspond

Récupère le contenu du champ d’en-tête de demande If-None-Match.

_requête WinHTTP _ si la _ plage

Récupère le contenu du champ d’en-tête de demande If-Range. 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 composants que l’application cliente est manquante. Si l’entité a été mise à jour, envoyez la totalité de l’entité mise à jour.

_requête WinHTTP _ si non _ modifiée _ depuis

Récupère le contenu du champ d’en-tête de demande If-Unmodified-Since.

_lien de requête WinHTTP _

Obsolète. Conservé pour la compatibilité des applications héritées.

_ _ dernière _ modification de la requête WinHTTP

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.

emplacement de la _ requête WinHTTP _

Récupère l’URI absolu utilisé dans un en-tête de réponse d’emplacement.

Max. des _ requêtes WinHTTP _

Indique la valeur maximale d’une _ valeur de requête WinHTTP _ * . N’est pas un indicateur de requête.

_ _ nombre maximal de transferts de requêtes WinHTTP _

Récupère le nombre de proxies ou de passerelles qui peuvent transférer la requête vers le serveur entrant suivant.

_ID de _ message de requête WinHTTP _

Non pris en charge.

_ _ version MIME de la requête WinHTTP _

Reçoit la version du protocole MIME (Multipurpose Internet Mail Extensions) qui a été utilisée pour construire le message.

_ _ URI orig de la requête WinHTTP _

Obsolète. Conservé pour la compatibilité des applications héritées.

_pragma de requête WinHTTP _

Reçoit les directives spécifiques à l’implémentation qui peuvent s’appliquer à n’importe quel destinataire le long de la chaîne de requête/réponse.

_authentification du _ proxy de requête WinHTTP _

Récupère le schéma et le domaine d’authentification retournés par le proxy.

_autorisation du _ proxy de requête WinHTTP _

Récupère l’en-tête utilisé pour identifier l’utilisateur sur un proxy qui requiert une authentification. Cet en-tête ne peut être récupéré que si la demande est envoyée au serveur.

_ _ connexion proxy de requête WinHTTP _

Récupère l’en-tête de Proxy-Connection.

_ _ prise en charge du proxy de requêtes WinHTTP _

Récupère l’en-tête de Proxy-Support.

_requête WinHTTP _ publique

Reçoit les verbes HTTP disponibles sur ce serveur.

_plage de requêtes WinHTTP _

Récupère la plage d’octets d’une entité.

_ _ en-têtes bruts de requête WinHTTP _

Reçoit tous les en-têtes retournés par le serveur. Chaque en-tête se termine par « \ 0 ». Un « \ 0 » supplémentaire termine la liste des en-têtes.

_ _ en-têtes bruts de requête WinHTTP _ _ 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/saut de ligne (CR/LF).

_référenceur de requêtes WinHTTP _

Reçoit l’URI de la ressource dans laquelle l’URI demandé a été obtenu.

_actualisation des requêtes WinHTTP _

Obsolète. Conservé pour la compatibilité des applications héritées.

_méthode de _ demande de requête WinHTTP _

Reçoit le verbe HTTP qui est utilisé dans la demande, en général, obtenir ou poster.

_nouvelle tentative de requête WinHTTP _ _ après

Récupère la durée pendant laquelle le service est censé ne pas être disponible.

_serveur de requêtes WinHTTP _

Récupère des informations sur le logiciel utilisé par le serveur d’origine pour traiter la demande.

_cookie de _ jeu de requêtes WinHTTP _

Reçoit la valeur du cookie défini pour la demande.

CODE d’état de la _ requête WinHTTP _ _

Reçoit le code d’état retourné par le serveur. Pour obtenir la liste des valeurs possibles, consultez codes d’État http.

texte d’état de la _ requête WinHTTP _ _

Reçoit du texte supplémentaire retourné par le serveur sur la ligne de réponse.

titre de la _ requête WinHTTP _

Obsolète. Conservé pour la compatibilité des applications héritées.

encodage de _ transfert de requêtes WinHTTP _ _

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.

_requête WinHTTP _ sauf _ modification _ depuis

Récupère l’en-tête If-Modified-Since.

_ _ mise à niveau des requêtes WinHTTP

Récupère les protocoles de communication supplémentaires pris en charge par le serveur.

_URI de requête WinHTTP _

Reçoit tout ou partie de l’URI par lequel la ressource d’URI de requête peut être identifiée.

_ _ agent utilisateur de requête WinHTTP _

Récupère des informations sur l’agent utilisateur qui a effectué la demande.

variation de la _ requête WinHTTP _

Récupère l’en-tête qui indique que l’entité a été sélectionnée à partir de plusieurs représentations disponibles de la réponse à l’aide de la négociation pilotée par le serveur.

VERSION de la _ requête WinHTTP _

Récupère la version HTTP qui est présente dans la ligne d’État.

_requête WinHTTP _ via

Récupère les protocoles et destinataires intermédiaires entre l’agent utilisateur et le serveur sur les demandes, et entre le serveur d’origine et le client sur les réponses.

_avertissement de requête WinHTTP _

Récupère des informations supplémentaires sur l’état d’une réponse qui n’est peut-être pas reflétée par le code d’état de réponse.

_interrogation _ WinHTTP _ authentification Web

Récupère le schéma et le domaine d’authentification retournés par le serveur.

Les indicateurs de modificateur sont utilisés conjointement avec un indicateur d’attribut pour modifier la requête. Les indicateurs de modificateur modifient le format des données retournées ou indiquent où la fonction WinHttpQueryHeaders doit rechercher les informations.

Numéro de l' _ indicateur de requête WinHTTP _ _

Retourne les données sous la forme d’un nombre 32 bits pour les en-têtes dont la valeur est un nombre, tel que le code d’État.

_ _ _ en-têtes de demande d’indicateur de requête WinHTTP _

Interroge uniquement les en-têtes de demande.

_indicateur de requête WinHTTP _ _ SystemTime

Retourne la valeur d’en-tête en tant que structure SystemTime , ce 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 ».

codes de fin de l' _ indicateur de requête WinHTTP _ _

Requêtes de codes de fin de réponse. Avant d’interroger des codes de fin de réponse, vous devez appeler WinHttpReadData jusqu’à ce qu’il retourne 0 octet lu.

encodage de câble de l' _ indicateur de requête WinHTTP _ _ _

Par défaut, WinHttpQueryHeaders effectue une conversion Unicode avant de retourner l’en-tête qui a été 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 Professional avec les [ applications de bureau SP3 uniquement]
Serveur minimal pris en charge Windows server 2003, Windows 2000 server avec des [ applications de bureau SP3 uniquement]
En-tête
WinHTTP. h

Voir aussi