enumeración HTTP_VERB (http.h)

  • Artículo

El tipo de enumeración HTTP_VERB define valores que se usan para especificar verbos HTTP conocidos y estándar en la estructura HTTP_REQUEST . La mayoría de estos verbos conocidos se documentan en RFC 2616 y RFC 2518, como se indica a continuación.

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
No relevante para las aplicaciones; solo se usa en modo kernel.
HttpVerbUnknown
Indica que la aplicación puede examinar los miembros UnknownVerbLength y pUnknownVerb de la estructura HTTP_REQUEST para recuperar el verbo HTTP de la solicitud. Este es el caso de una solicitud HTTP/1.1 cuando un cliente del explorador especifica un verbo personalizado.
HttpVerbInvalid
No relevante para las aplicaciones; solo se usa en modo kernel.
HttpVerbOPTIONS
El método OPTIONS solicita información sobre las opciones de comunicación y los requisitos asociados a un URI.


Consulte la página 52 de RFC 2616.
HttpVerbGET
El método GET recupera la información o entidad identificada por el URI de la solicitud. Si ese URI hace referencia a un script u otro proceso de producción de datos, son los datos generados, no el texto del script, que se devuelve en la respuesta.

Un método GET se puede hacer condicional o parcial mediante la inclusión de un campo de encabezado condicional o range en la solicitud. Una solicitud GET condicional que la entidad se envía solo si se cumplen todas las condiciones especificadas en el encabezado y una get parcial solicita solo parte de la entidad, tal como se especifica en el encabezado Range. Ambas formas de GET pueden ayudar a evitar el tráfico de red innecesario.


Consulte la página 53 de RFC 2616.
HttpVerbHEAD
El método HEAD es idéntico a GET, excepto que el servidor sólo devuelve los encabezados de mensaje en la respuesta, sin el cuerpo del mensaje. Los encabezados son los mismos que se devolverían en respuesta a get.


Consulte la página 54 de RFC 2616.
HttpVerbPOST
El método POST se usa para publicar una nueva entidad como adición a un URI.
El URI identifica una entidad que consume los datos publicados de alguna manera.


Consulte la página 54 de RFC 2616.
HttpVerbPUT
El método PUT se usa para reemplazar una entidad identificada por un URI.


Consulte la página 55 de RFC 2616.
HttpVerbDELETE
The
Delete solicita que se elimine un URI especificado.


Consulte la página 56 de RFC 2616.
HttpVerbTRACE
El método TRACE invoca un bucle invertido remoto de capa de aplicación del mensaje de solicitud.
Permite al cliente ver lo que se recibe en el otro
final de la cadena de solicitudes para el diagnóstico
Propósitos. Consulte la página 56 de RFC 2616.
HttpVerbCONNECT
The CONNECT
se puede usar con un proxy que puede cambiar dinámicamente a la tunelización, como en el caso de la tunelización SSL. Consulte la página 57 de RFC 2616.
HttpVerbTRACK
Microsoft Cluster Server usa el método TRACK para implementar un seguimiento no registrado.
HttpVerbMOVE
El método MOVE solicita una operación WebDAV
equivalente a una copia (COPY), seguida de mantenimiento de coherencia
procesamiento, seguido de una eliminación del origen, donde los tres
las acciones se realizan de forma atómica. Cuando se aplica a una colección, se supone que "Depth" es o debe especificarse como "infinito". Consulte la página 42 de RFC 2518.
HttpVerbCOPY
El método COPY solicita una operación WebDAV que crea un duplicado del recurso de origen,
identificado por el URI de solicitud, en el recurso de destino,
identificado por un URI especificado en el encabezado Destination. Consulte la página 37 de RFC 2518.
HttpVerbPROPFIND
El método PROPFIND solicita una operación WebDAV que recupera las propiedades definidas en el recurso.
identificado por request-URI. Consulte la página 24 de RFC 2518.
HttpVerbPROPPATCH
El método PROPPATCH solicita una operación WebDAV que establece o quita las propiedades definidas en el recurso.
identificado por request-URI. Consulte la página 31 de RFC 2518.
HttpVerbMKCOL
El método MKCOL solicita una operación WebDAV que crea una nueva colección
recurso en la ubicación especificada por
Request-URI. Consulte la página 33 de RFC 2518.
HttpVerbLOCK
El método LOCK solicita una operación WebDAV que crea un bloqueo según lo especificado por lockinfo.
Elemento XML en request-URI. Consulte la página 45 de RFC 2518.
HttpVerbUNLOCK
El método UNLOCK solicita una operación WebDAV que quita un bloqueo, identificado por un token de bloqueo en
el encabezado de solicitud Lock-Token, del recurso identificado por el URI de solicitud y del resto
recursos incluidos en el bloqueo. Consulte la página 51 de RFC 2518.
HttpVerbSEARCH
El método SEARCH solicita una operación WebDAV usada por
Microsoft Exchange para buscar carpetas. Consulte internet Engineering Task Force (IETF) Internet Draft WebDAV SEARCH (Internet Draft WebDAV SEARCH) para obtener más información y el sitio web de WebDAV para obtener posibles actualizaciones.
HttpVerbMaximum
Finaliza la enumeración; no se usa para definir un verbo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado http.h

Consulte también

HTTP_REQUEST