Indicateurs d’informations de requête (Wininet.h)

Les listes suivantes contiennent les attributs et modificateurs utilisés par HttpQueryInfo et QueryInfo.

Les indicateurs d’attribut sont utilisés par HttpQueryInfo (ou QueryInfo) pour indiquer les données à 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 HTTP_QUERY_RAW_HEADERS, qui ne sont pas liés à un en-tête spécifique.

HTTP_QUERY_ACCEPT

24

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

HTTP_QUERY_ACCEPT_CHARSET

25

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

HTTP_QUERY_ACCEPT_ENCODING

26

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

HTTP_QUERY_ACCEPT_LANGUAGE

27

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

HTTP_QUERY_ACCEPT_RANGES

42

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

HTTP_QUERY_AGE

48

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

HTTP_QUERY_ALLOW

7

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

HTTP_QUERY_AUTHORIZATION

28

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

HTTP_QUERY_CACHE_CONTROL

49

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

HTTP_QUERY_CONNECTION

23

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

HTTP_QUERY_CONTENT_BASE

50

Récupère l’URI de base (Uniform Resource Identifier) pour résoudre les URL relatives au sein de l’entité.

HTTP_QUERY_CONTENT_DESCRIPTION

4

Obsolète. Géré pour la compatibilité des applications héritées uniquement.

HTTP_QUERY_CONTENT_DISPOSITION

47

Obsolète. Géré pour la compatibilité des applications héritées uniquement.

HTTP_QUERY_CONTENT_ENCODING

29

Récupère tous les codages de contenu supplémentaires qui ont été appliqués à l’ensemble de la ressource.

HTTP_QUERY_CONTENT_ID

3

Récupère l’identification de contenu.

HTTP_QUERY_CONTENT_LANGUAGE

6

Récupère la langue dans laquelle se trouve le contenu.

HTTP_QUERY_CONTENT_LENGTH

5

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

HTTP_QUERY_CONTENT_LOCATION

51

Récupère l’emplacement de ressource de l’entité placée dans le message.

HTTP_QUERY_CONTENT_MD5

52

Récupère une synthèse MD5 du corps de l’entité dans le but de fournir un case activée d’intégrité du message de bout en bout (MIC) pour le corps de l’entité. Pour plus d’informations, consultez RFC1864, Le champ d’en-tête Content-MD5, à l’adresse https://ftp.isi.edu/in-notes/rfc1864.txt.

HTTP_QUERY_CONTENT_RANGE

53

Récupère l’emplacement dans le corps d’entité complet où l’entité-body partielle doit être insérée et la taille totale de l’entité-body complet.

HTTP_QUERY_CONTENT_TRANSFER_ENCODING

2

Reçoit le codage de contenu supplémentaire qui a été appliqué à la ressource.

HTTP_QUERY_CONTENT_TYPE

1

Reçoit le type de contenu de la ressource (par exemple, texte/html).

HTTP_QUERY_COOKIE

44

Récupère tous les cookies associés à la demande.

HTTP_QUERY_COST

15

N'est plus pris en charge.

HTTP_QUERY_CUSTOM

65535

Permet à HttpQueryInfo de rechercher le nom d’en-tête spécifié dans lpvBuffer et de stocker les données d’en-tête dans lpvBuffer.

HTTP_QUERY_DATE

9

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

HTTP_QUERY_DERIVED_FROM

14

N'est plus pris en charge.

HTTP_QUERY_ECHO_HEADERS

73

Actuellement non implémenté.

HTTP_QUERY_ECHO_HEADERS_CRLF

74

Actuellement non implémenté.

HTTP_QUERY_ECHO_REPLY

72

Actuellement non implémenté.

HTTP_QUERY_ECHO_REQUEST

71

Actuellement non implémenté.

HTTP_QUERY_ETAG

54

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

HTTP_QUERY_EXPECT

68

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

HTTP_QUERY_EXPIRES

10

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

HTTP_QUERY_FORWARDED

30

Obsolète. Tenu à jour pour la compatibilité des applications héritées uniquement.

HTTP_QUERY_FROM

31

Récupère l’adresse e-mail de l’utilisateur humain qui contrôle l’agent utilisateur demandeur si l’en-tête From est donné.

HTTP_QUERY_HOST

55

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

HTTP_QUERY_IF_MATCH

56

Récupère le contenu du champ If-Match request-header.

HTTP_QUERY_IF_MODIFIED_SINCE

32

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

HTTP_QUERY_IF_NONE_MATCH

57

Récupère le contenu du champ If-None-Match request-header.

HTTP_QUERY_IF_RANGE

58

Récupère le contenu du champ If-Range request-header. Cet en-tête permet à l’application cliente de vérifier que l’entité associé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.

HTTP_QUERY_IF_UNMODIFIED_SINCE

59

Récupère le contenu du champ If-Unmodified-Since request-header.

HTTP_QUERY_LAST_MODIFIED

11

Reçoit la date et l’heure auxquelles le serveur croit que la ressource a été modifiée pour la dernière fois.

HTTP_QUERY_LINK

16

Obsolète. Tenu à jour pour la compatibilité des applications héritées uniquement.

HTTP_QUERY_LOCATION

33

Récupère l’URI (Uniform Resource Identifier) absolu utilisé dans un emplacement response-header.

HTTP_QUERY_MAX

78

Pas un indicateur de requête. Indique la valeur maximale d’une valeur HTTP_QUERY_*.

HTTP_QUERY_MAX_FORWARDS

60

Récupère le nombre de proxys ou de passerelles pouvant transférer la demande au serveur entrant suivant.

HTTP_QUERY_MESSAGE_ID

12

N'est plus pris en charge.

HTTP_QUERY_MIME_VERSION

0

Reçoit la version du protocole MIME qui a été utilisée pour construire le message.

HTTP_QUERY_ORIG_URI

34

Obsolète. Tenu à jour pour la compatibilité des applications héritées uniquement.

HTTP_QUERY_PRAGMA

17

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.

HTTP_QUERY_PROXY_AUTHENTICATE

41

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

HTTP_QUERY_PROXY_AUTHORIZATION

61

Récupère l’en-tête utilisé pour identifier l’utilisateur sur 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.

HTTP_QUERY_PROXY_CONNECTION

69

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

HTTP_QUERY_PUBLIC

8

Reçoit les méthodes disponibles sur ce serveur.

HTTP_QUERY_RANGE

62

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

HTTP_QUERY_RAW_HEADERS

21

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.

HTTP_QUERY_RAW_HEADERS_CRLF

22

Reçoit tous les en-têtes retournés par le serveur. Chaque en-tête est séparé par une séquence retour chariot/saut de ligne (CR/LF).

HTTP_QUERY_REFERER

35

Reçoit l’URI (Uniform Resource Identifier) de la ressource où l’URI demandé a été obtenu.

HTTP_QUERY_REFRESH

46

Obsolète. Géré pour la compatibilité des applications héritées uniquement.

HTTP_QUERY_REQUEST_METHOD

45

Reçoit le verbe HTTP utilisé dans la requête, généralement GET ou POST.

HTTP_QUERY_RETRY_AFTER

36

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

HTTP_QUERY_SERVER

37

Récupère des données sur le logiciel utilisé par le serveur d’origine pour gérer la demande.

HTTP_QUERY_SET_COOKIE

43

Reçoit la valeur du jeu de cookies pour la demande.

HTTP_QUERY_STATUS_CODE

19

Reçoit le code status retourné par le serveur. Pour plus d’informations et une liste de valeurs possibles, consultez Codes d’état HTTP.

HTTP_QUERY_STATUS_TEXT

20

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

HTTP_QUERY_TITLE

38

Obsolète. Géré pour la compatibilité des applications héritées uniquement.

HTTP_QUERY_TRANSFER_ENCODING

63

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.

HTTP_QUERY_UNLESS_MODIFIED_SINCE

70

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

HTTP_QUERY_UPGRADE

64

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

HTTP_QUERY_URI

13

Reçoit tout ou partie des URI (Uniform Resource Identifiers) par lesquels la ressource Request-URI peut être identifiée.

HTTP_QUERY_USER_AGENT

39

Récupère les données relatives à l’agent utilisateur qui a effectué la demande.

HTTP_QUERY_VARY

65

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.

HTTP_QUERY_VERSION

18

Reçoit le dernier code de réponse retourné par le serveur.

HTTP_QUERY_VIA

66

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.

HTTP_QUERY_WARNING

67

Récupère des données supplémentaires sur la status d’une réponse qui ne sont peut-être pas reflétées par le code status de réponse.

HTTP_QUERY_WWW_AUTHENTICATE

40

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

HTTP_QUERY_X_CONTENT_TYPE_OPTIONS

79

Récupère la valeur d’en-tête X-Content-Type-Options.

HTTP_QUERY_P3P

80

Récupère la valeur d’en-tête P3P.

HTTP_QUERY_X_P2P_PEERDIST

81

Récupère la valeur d’en-tête X-P2P-PeerDist.

HTTP_QUERY_TRANSLATE

82

Récupère la valeur d’en-tête translate.

HTTP_QUERY_X_UA_COMPATIBLE

83

Récupère la valeur d’en-tête compatible X-UA.

HTTP_QUERY_DEFAULT_STYLE

84

Récupère la valeur d’en-tête Default-Style.

HTTP_QUERY_X_FRAME_OPTIONS

85 %

Récupère la valeur d’en-tête X-Frame-Options.

HTTP_QUERY_X_XSS_PROTECTION

86

Récupère la valeur d’en-tête X-XSS-Protection.

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ù HttpQueryInfo (ou QueryInfo) doit rechercher les données.

HTTP_QUERY_FLAG_COALESCE

0x10000000

Non implémenté.

HTTP_QUERY_FLAG_NUMBER

0x20000000

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

HTTP_QUERY_FLAG_REQUEST_HEADERS

0x80000000

Les requêtes demandent uniquement des en-têtes.

HTTP_QUERY_FLAG_SYSTEMTIME

0x40000000

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 ».

Remarques

Notes

WinINet ne prend pas en charge les implémentations de serveur. En outre, il ne doit pas être utilisé à partir d’un service. Pour les implémentations de serveur ou les services, utilisez Microsoft Windows HTTP Services (WinHTTP).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Wininet.h