Partager via

énumération HTTP_VERB (http.h)

  • Article

Le type d’énumération HTTP_VERB définit les valeurs utilisées pour spécifier des verbes HTTP standard connus dans la structure HTTP_REQUEST . La majorité de ces verbes connus sont documentés dans RFC 2616 et RFC 2518, comme indiqué ci-dessous.

Syntax

typedef enum _HTTP_VERB {
  HttpVerbUnparsed,
  HttpVerbUnknown,
  HttpVerbInvalid,
  HttpVerbOPTIONS,
  HttpVerbGET,
  HttpVerbHEAD,
  HttpVerbPOST,
  HttpVerbPUT,
  HttpVerbDELETE,
  HttpVerbTRACE,
  HttpVerbCONNECT,
  HttpVerbTRACK,
  HttpVerbMOVE,
  HttpVerbCOPY,
  HttpVerbPROPFIND,
  HttpVerbPROPPATCH,
  HttpVerbMKCOL,
  HttpVerbLOCK,
  HttpVerbUNLOCK,
  HttpVerbSEARCH,
  HttpVerbMaximum
} HTTP_VERB, *PHTTP_VERB;

Constantes

 
HttpVerbUnparsed
Non pertinent pour les applications ; utilisé uniquement en mode noyau.
HttpVerbUnknown
Indique que l’application peut examiner les membres UnknownVerbLength et pUnknownVerb de la structure HTTP_REQUEST pour récupérer le verbe HTTP de la requête. C’est le cas dans une requête HTTP/1.1 lorsqu’un client de navigateur spécifie un verbe personnalisé.
HttpVerbInvalid
Non pertinent pour les applications ; utilisé uniquement en mode noyau.
HttpVerbOPTIONS
La méthode OPTIONS demande des informations sur les options de communication et les exigences associées à un URI.


Voir la page 52 de la RFC 2616.
HttpVerbGET
La méthode GET récupère les informations ou l’entité identifiées par l’URI de la requête. Si cet URI fait référence à un script ou à un autre processus de production de données, ce sont les données produites, et non le texte du script, qui sont retournées dans la réponse.

Une méthode GET peut être rendue conditionnelle ou partielle en incluant un champ d’en-tête conditionnel ou de plage dans la requête. Un GET conditionnel demande que l’entité soit envoyée uniquement si toutes les conditions spécifiées dans l’en-tête sont remplies, et une requête GET partielle ne demande qu’une partie de l’entité, comme spécifié dans l’en-tête Range. Ces deux formes de GET peuvent vous aider à éviter le trafic réseau inutile.


Consultez la page 53 de la RFC 2616.
HttpVerbHEAD
La méthode HEAD est identique à GET, mais le serveur retourne uniquement des en-têtes de message dans la réponse, sans corps du message. Les en-têtes sont identiques à ce qui serait retourné en réponse à un GET.


Consultez la page 54 de la RFC 2616.
HttpVerbPOST
La méthode POST est utilisée pour publier une nouvelle entité en tant qu’ajout à un URI.
L’URI identifie une entité qui consomme les données publiées d’une manière ou d’une autre.


Consultez la page 54 de la RFC 2616.
HttpVerbPUT
La méthode PUT est utilisée pour remplacer une entité identifiée par un URI.


Consultez la page 55 de la RFC 2616.
HttpVerbDELETE
The
La méthode DELETE demande la suppression d’un URI spécifié.


Consultez la page 56 de la RFC 2616.
HttpVerbTRACE
La méthode TRACE appelle une boucle de la couche application distante du message de requête.
Il permet au client de voir ce qui est reçu à l’autre
fin de la chaîne de requêtes pour le diagnostic
Fins. Consultez la page 56 de la RFC 2616.
HttpVerbCONNECT
The CONNECT
la méthode peut être utilisée avec un proxy qui peut basculer dynamiquement vers le tunneling, comme dans le cas du tunneling SSL. Consultez la page 57 de la RFC 2616.
HttpVerbTRACK
La méthode TRACK est utilisée par Microsoft Cluster Server pour implémenter une trace non journalisée.
HttpVerbMOVE
La méthode MOVE demande une opération WebDAV
équivalent à une copie (COPY), suivie d’une maintenance de cohérence
traitement, suivi d’une suppression de la source, où les trois
les actions sont effectuées de manière atomique. Lorsqu’il est appliqué à une collection, « Depth » est supposé être ou doit être spécifié comme « infini ». Consultez la page 42 de la RFC 2518.
HttpVerbCOPY
La méthode COPY demande une opération WebDAV qui crée un doublon de la ressource source,
identifié par l’URI de requête, dans la ressource de destination,
identifié par un URI spécifié dans l’en-tête Destination. Voir la page 37 de la RFC 2518.
HttpVerbPROPFIND
La méthode PROPFIND demande une opération WebDAV qui récupère les propriétés définies sur la ressource
identifié par l’URI de requête. Consultez la page 24 de la RFC 2518.
HttpVerbPROPPATCH
La méthode PROPPATCH demande une opération WebDAV qui définit et/ou supprime des propriétés définies sur la ressource
identifié par l’URI de requête. Consultez la page 31 de la RFC 2518.
HttpVerbMKCOL
La méthode MKCOL demande une opération WebDAV qui crée une collection
ressource à l’emplacement spécifié par
l’URI de requête. Consultez la page 33 de la RFC 2518.
HttpVerbLOCK
La méthode LOCK demande une opération WebDAV qui crée un verrou comme spécifié par lockinfo
Élément XML sur l’URI de requête. Consultez la page 45 de la RFC 2518.
HttpVerbUNLOCK
La méthode UNLOCK demande une opération WebDAV qui supprime un verrou identifié par un jeton de verrouillage dans
l’en-tête de requête Lock-Token, à partir de la ressource identifiée par l’URI de requête et de tous les autres
ressources incluses dans le verrou. Consultez la page 51 de la RFC 2518.
HttpVerbSEARCH
La méthode SEARCH demande une opération WebDAV utilisée par
Microsoft Exchange pour rechercher des dossiers. Pour plus d’informations, consultez Internet Engineering Task Force (IETF) Internet Draft WebDAV SEARCH et le site Web WebDAV pour connaître les mises à jour possibles.
HttpVerbMaximum
Met fin à l’énumération ; n’est pas utilisé pour définir un verbe.

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