énumération HTTP_VERB (http.h)

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