enumerazione HTTP_VERB (http.h)

  • Articolo

Il tipo di enumerazione HTTP_VERB definisce i valori utilizzati per specificare verbi HTTP noti e standard nella struttura HTTP_REQUEST . La maggior parte di questi verbi noti è documentata in RFC 2616 e RFC 2518, come indicato di seguito.

Sintassi

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;

Costanti

 
HttpVerbUnparsed
Non pertinente per le applicazioni; usato solo in modalità kernel.
HttpVerbUnknown
Indica che l'applicazione può esaminare i membri UnknownVerbLength e pUnknownVerb della struttura HTTP_REQUEST per recuperare il verbo HTTP per la richiesta. Questo avviene in una richiesta HTTP/1.1 quando un client del browser specifica un verbo personalizzato.
HttpVerbInvalid
Non pertinente per le applicazioni; usato solo in modalità kernel.
HttpVerbOPTIONS
Il metodo OPTIONS richiede informazioni sulle opzioni di comunicazione e sui requisiti associati a un URI.


Vedere la pagina 52 di RFC 2616.
HttpVerbGET
Il metodo GET recupera le informazioni o l'entità identificata dall'URI della richiesta. Se tale URI fa riferimento a uno script o a un altro processo di produzione di dati, i dati generati, non il testo dello script, restituito nella risposta.

Un metodo GET può essere reso condizionale o parziale includendo un campo di intestazione condizionale o range nella richiesta. Un get condizionale richiede che l'entità venga inviata solo se vengono soddisfatte tutte le condizioni specificate nell'intestazione e una richiesta GET parziale solo parte dell'entità, come specificato nell'intestazione Range. Entrambe queste forme di GET consentono di evitare il traffico di rete non necessario.


Vedere la pagina 53 di RFC 2616.
HttpVerbHEAD
Il metodo HEAD è identico al metodo GET ad eccezione del fatto che, nella risposta, il server restituisce solo intestazioni di messaggio senza un corpo del messaggio. Le intestazioni corrispondono a come verrebbero restituite in risposta a get.


Vedere la pagina 54 di RFC 2616.
HttpVerbPOST
Il metodo POST viene usato per pubblicare una nuova entità come aggiunta a un URI.
L'URI identifica un'entità che utilizza i dati pubblicati in qualche modo.


Vedere la pagina 54 di RFC 2616.
HttpVerbPUT
Il metodo PUT viene usato per sostituire un'entità identificata da un URI.


Vedere la pagina 55 di RFC 2616.
HttpVerbDELETE
The
Il metodo DELETE richiede l'eliminazione di un URI specificato.


Vedere la pagina 56 di RFC 2616.
HttpVerbTRACE
Il metodo TRACE richiama un loopback a livello di applicazione remoto del messaggio di richiesta.
Consente al client di vedere cosa viene ricevuto all'altro
fine della catena di richieste per la diagnostica
Scopi. Vedere la pagina 56 di RFC 2616.
HttpVerbCONNECT
The CONNECT
è possibile usare il metodo con un proxy che può passare dinamicamente al tunneling, come nel caso del tunneling SSL. Vedere la pagina 57 di RFC 2616.
HttpVerbTRACK
Il metodo TRACK viene usato da Microsoft Cluster Server per implementare una traccia non registrata.
HttpVerbMOVE
Il metodo MOVE richiede un'operazione WebDAV
equivalente a una copia (COPY), seguita dalla manutenzione della coerenza
elaborazione, seguita da un'eliminazione dell'origine, dove tutte e tre
le azioni vengono eseguite in modo atomico. Se applicato a una raccolta, si presuppone che "Depth" sia o debba essere specificato come "infinity". Vedere la pagina 42 di RFC 2518.
HttpVerbCOPY
Il metodo COPY richiede un'operazione WebDAV che crea un duplicato della risorsa di origine,
identificato dall'URI della richiesta, nella risorsa di destinazione,
identificato da un URI specificato nell'intestazione Destinazione. Vedere la pagina 37 di RFC 2518.
HttpVerbPROPFIND
Il metodo PROPFIND richiede un'operazione WebDAV che recupera le proprietà definite nella risorsa
identificato dall'URI della richiesta. Vedere la pagina 24 di RFC 2518.
HttpVerbPROPPATCH
Il metodo PROPPATCH richiede un'operazione WebDAV che imposta e/o rimuove le proprietà definite nella risorsa
identificato dall'URI della richiesta. Vedere la pagina 31 di RFC 2518.
HttpVerbMKCOL
Il metodo MKCOL richiede un'operazione WebDAV che crea una nuova raccolta
risorsa nella posizione specificata da
Request-URI. Vedere la pagina 33 di RFC 2518.
HttpVerbLOCK
Il metodo LOCK richiede un'operazione WebDAV che crea un blocco come specificato dall'elemento lockinfo
Elemento XML nell'URI request. Vedere la pagina 45 di RFC 2518.
HttpVerbUNLOCK
Il metodo UNLOCK richiede un'operazione WebDAV che rimuove un blocco, identificato da un token di blocco in
l'intestazione della richiesta di Lock-Token, dalla risorsa identificata dall'URI richiesta e da tutte le altre
risorse incluse nel blocco. Vedere la pagina 51 di RFC 2518.
HttpVerbSEARCH
Il metodo SEARCH richiede un'operazione WebDAV usata da
Microsoft Exchange per eseguire ricerche nelle cartelle. Per altre informazioni, vedere Internet Engineering Task Force (IETF) Internet Draft WebDAV SEARCH per ulteriori informazioni e il sito Web WebDAV .
HttpVerbMaximum
Termina l'enumerazione; non viene utilizzato per definire un verbo.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione http.h

Vedi anche

HTTP_REQUEST