enumeração HTTP_VERB (http.h)

  • Artigo

O tipo de enumeração HTTP_VERB define valores que são usados para especificar verbos HTTP padrão conhecidos na estrutura HTTP_REQUEST . A maioria desses verbos conhecidos está documentada em RFC 2616 e RFC 2518, conforme indicado abaixo.

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
Não relevante para aplicativos; usado somente no modo kernel.
HttpVerbUnknown
Indica que o aplicativo pode examinar os membros UnknownVerbLength e pUnknownVerb da estrutura HTTP_REQUEST para recuperar o verbo HTTP da solicitação. Esse é o caso em uma solicitação HTTP/1.1 quando um cliente do navegador especifica um verbo personalizado.
HttpVerbInvalid
Não relevante para aplicativos; usado somente no modo kernel.
HttpVerbOPTIONS
O método OPTIONS solicita informações sobre as opções de comunicação e os requisitos associados a um URI.


Consulte a página 52 do RFC 2616.
HttpVerbGET
O método GET recupera as informações ou a entidade identificadas pelo URI da Solicitação. Se esse URI se referir a um script ou outro processo de produção de dados, são os dados produzidos, não o texto do script, que são retornados na resposta.

Um método GET pode ser condicional ou parcial, incluindo um campo de cabeçalho condicional ou Range na solicitação. Um GET condicional solicita que a entidade seja enviada somente se todas as condições especificadas no cabeçalho forem atendidas e uma get parcial solicitará apenas parte da entidade, conforme especificado no cabeçalho Range. Ambas as formas de GET podem ajudar a evitar o tráfego de rede desnecessário.


Consulte a página 53 do RFC 2616.
HttpVerbHEAD
O método HEAD é idêntico ao GET, exceto que o servidor retorna apenas cabeçalhos de mensagem na resposta, sem um corpo de mensagem. Os cabeçalhos são os mesmos que seriam retornados em resposta a um GET.


Consulte a página 54 do RFC 2616.
HttpVerbPOST
O método POST é usado para postar uma nova entidade como uma adição a um URI.
O URI identifica uma entidade que consome os dados postados de alguma forma.


Consulte a página 54 do RFC 2616.
HttpVerbPUT
O método PUT é usado para substituir uma entidade identificada por um URI.


Consulte a página 55 do RFC 2616.
HttpVerbDELETE
O
O método DELETE solicita que um URI especificado seja excluído.


Consulte a página 56 do RFC 2616.
HttpVerbTRACE
O método TRACE invoca um loop-back remoto da camada de aplicativo da mensagem de solicitação.
Ele permite que o cliente veja o que está sendo recebido no outro
fim da cadeia de solicitações para diagnóstico
Fins. Consulte a página 56 do RFC 2616.
HttpVerbCONNECT
O CONNECT
O método pode ser usado com um proxy que pode alternar dinamicamente para o túnel, como no caso do túnel SSL. Consulte a página 57 do RFC 2616.
HttpVerbTRACK
O método TRACK é usado pelo Microsoft Cluster Server para implementar um rastreamento não registrado.
HttpVerbMOVE
O método MOVE solicita uma operação WebDAV
equivalente a uma cópia (COPY), seguido pela manutenção de consistência
processamento, seguido por uma exclusão da origem, em que todos os três
as ações são executadas atomicamente. Quando aplicado a uma coleção, "Depth" é considerado ou deve ser especificado como "infinito". Consulte a página 42 do RFC 2518.
HttpVerbCOPY
O método COPY solicita uma operação WebDAV que cria uma duplicata do recurso de origem,
identificado pelo URI de solicitação, no recurso de destino,
identificado por um URI especificado no cabeçalho Destino. Consulte a página 37 do RFC 2518.
HttpVerbPROPFIND
O método PROPFIND solicita uma operação WebDAV que recupera as propriedades definidas no recurso
identificado pelo Request-URI. Consulte a página 24 do RFC 2518.
HttpVerbPROPPATCH
O método PROPPATCH solicita uma operação WebDAV que define e/ou remove propriedades definidas no recurso
identificado pelo Request-URI. Consulte a página 31 do RFC 2518.
HttpVerbMKCOL
O método MKCOL solicita uma operação WebDAV que cria uma nova coleção
recurso no local especificado por
o Request-URI. Consulte a página 33 do RFC 2518.
HttpVerbLOCK
O método LOCK solicita uma operação WebDAV que cria um bloqueio conforme especificado pelo lockinfo
Elemento XML no Request-URI. Consulte a página 45 do RFC 2518.
HttpVerbUNLOCK
O método UNLOCK solicita uma operação WebDAV que remove um bloqueio, identificado por um token de bloqueio no
o cabeçalho de solicitação Lock-Token, do recurso identificado pelo Request-URI e de todos os outros
recursos incluídos no bloqueio. Consulte a página 51 do RFC 2518.
HttpVerbSEARCH
O método SEARCH solicita uma operação WebDAV usada pelo
Microsoft Exchange para pesquisar pastas. Consulte a Pesquisa webDAV de rascunho da Internet da IETF (Internet Engineering Task Force) para obter mais informações e o site do WebDAV para obter possíveis atualizações.
HttpVerbMaximum
Encerra a enumeração; não é usado para definir um verbo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho http.h

Confira também

HTTP_REQUEST