enumerazione HTTP_HEADER_ID (http.h)

Il tipo di enumerazione HTTP_HEADER_ID elenca le intestazioni note per le richieste e le risposte HTTP e associa un indice di matrice a ogni intestazione. Viene usato per dimensioni e accedere ai membri della matrice KnownHeaders delle strutture HTTP_REQUEST_HEADERS e HTTP_RESPONSE_HEADERS .

Sintassi

typedef enum _HTTP_HEADER_ID {
  HttpHeaderCacheControl = 0,
  HttpHeaderConnection = 1,
  HttpHeaderDate = 2,
  HttpHeaderKeepAlive = 3,
  HttpHeaderPragma = 4,
  HttpHeaderTrailer = 5,
  HttpHeaderTransferEncoding = 6,
  HttpHeaderUpgrade = 7,
  HttpHeaderVia = 8,
  HttpHeaderWarning = 9,
  HttpHeaderAllow = 10,
  HttpHeaderContentLength = 11,
  HttpHeaderContentType = 12,
  HttpHeaderContentEncoding = 13,
  HttpHeaderContentLanguage = 14,
  HttpHeaderContentLocation = 15,
  HttpHeaderContentMd5 = 16,
  HttpHeaderContentRange = 17,
  HttpHeaderExpires = 18,
  HttpHeaderLastModified = 19,
  HttpHeaderAccept = 20,
  HttpHeaderAcceptCharset = 21,
  HttpHeaderAcceptEncoding = 22,
  HttpHeaderAcceptLanguage = 23,
  HttpHeaderAuthorization = 24,
  HttpHeaderCookie = 25,
  HttpHeaderExpect = 26,
  HttpHeaderFrom = 27,
  HttpHeaderHost = 28,
  HttpHeaderIfMatch = 29,
  HttpHeaderIfModifiedSince = 30,
  HttpHeaderIfNoneMatch = 31,
  HttpHeaderIfRange = 32,
  HttpHeaderIfUnmodifiedSince = 33,
  HttpHeaderMaxForwards = 34,
  HttpHeaderProxyAuthorization = 35,
  HttpHeaderReferer = 36,
  HttpHeaderRange = 37,
  HttpHeaderTe = 38,
  HttpHeaderTranslate = 39,
  HttpHeaderUserAgent = 40,
  HttpHeaderRequestMaximum = 41,
  HttpHeaderAcceptRanges = 20,
  HttpHeaderAge = 21,
  HttpHeaderEtag = 22,
  HttpHeaderLocation = 23,
  HttpHeaderProxyAuthenticate = 24,
  HttpHeaderRetryAfter = 25,
  HttpHeaderServer = 26,
  HttpHeaderSetCookie = 27,
  HttpHeaderVary = 28,
  HttpHeaderWwwAuthenticate = 29,
  HttpHeaderResponseMaximum = 30,
  HttpHeaderMaximum = 41
} HTTP_HEADER_ID, *PHTTP_HEADER_ID;

Costanti

HttpHeaderCacheControl Valore: 0 Usato per specificare il comportamento di memorizzazione nella cache lungo la catena di richieste o di risposta, sostituendo l'algoritmo di memorizzazione nella cache predefinito.
HttpHeaderConnection Valore: 1 Consente al mittente di specificare le opzioni desiderate per tale connessione specifica. Questi vengono usati solo per una singola connessione e non devono essere comunicati dai proxy su ulteriori connessioni.
HttpHeaderDate Valore: 2 Data è un campo di intestazione generale che indica l'ora di invio della richiesta o della risposta.
HttpHeaderKeepAlive Valore: 3 In base all'elemento XML keepalive (vedere RFC 2518, sezione 12.12.1, pagina 66); elenco di URI inclusi in KeepAlive l'intestazione deve essere "live" dopo la copia (spostato) nella destinazione.
HttpHeaderPragma Valore: 4 Usato per includere direttive facoltative e specifiche dell'implementazione che potrebbero essere applicate a qualsiasi destinatario lungo la catena di richieste/risposta.
HttpHeaderTrailer Valore: 5 Indica che i campi di intestazione specificati sono presenti nel trailer di un messaggio codificato con codifica trasferimento blocchi.
HttpHeaderTransferEncoding Valore: 6 Indica cosa, se presente, le trasformazioni sono state applicate al corpo del messaggio in transito.
HttpHeaderUpgrade Valore: 7 Consente al client di specificare uno o più protocolli di comunicazione che preferisce usare se il server può essere conforme.
HttpHeaderVia Valore: 8 Il campo Intestazione Via indica il percorso eseguito dalla richiesta.
HttpHeaderWarning Valore: 9 Si tratta di un'intestazione di risposta che contiene il codice di avviso a 3 cifre insieme alla frase motivo.
HttpHeaderAllow Valore: 10 Elenchi il set di metodi supportati dalla risorsa identificata dall'URI richiesta.
HttpHeaderContentLength Valore: 11 Dimensioni del corpo del messaggio in byte decimali.
HttpHeaderContentType Valore: 12 Tipo di supporto del corpo del messaggio.
HttpHeaderContentEncoding Valore: 13 Schema di codifica per il corpo del messaggio.
HttpHeaderContentLanguage Valore: 14 Fornisce il linguaggio naturale del pubblico previsto.
HttpHeaderContentLocation Valore: 15 Posizione della risorsa per l'entità racchiusa nel messaggio quando tale entità è accessibile da una posizione separata dall'URI della risorsa richiesta.
HttpHeaderContentMd5 Valore: 16 Un digest MD5 del corpo dell'entità usato per fornire il controllo di integrità dei messaggi end-to-end del corpo dell'entità.
HttpHeaderContentRange Valore: 17 L'intestazione dell'intervallo di contenuto viene inviata con un corpo di entità parziale per specificare dove deve essere applicato il corpo parziale del corpo completo.
HttpHeaderExpires Valore: 18 Data e ora dopo la scadenza del contenuto del messaggio.
HttpHeaderLastModified Valore: 19 Indica la data e l'ora in cui il server di origine ritiene che la variante sia stata modificata.
HttpHeaderAccept Valore: 20 Usato con i metodi INVITE, OPTIONS e REGISTER per indicare quali tipi di supporti sono accettabili nella risposta.
HttpHeaderAcceptCharset Valore: 21 Indica i set di caratteri accettabili per la risposta.
HttpHeaderAcceptEncoding Valore: 22 Codifica del contenuto accettabile nella risposta.
HttpHeaderAcceptLanguage Valore: 23 Usato dal client per indicare al server quale lingua preferisce ricevere frasi motivo, descrizioni di sessione o risposte di stato.
HttpHeaderAuthorization Valore: 24 L'agente utente può autenticarsi con un server inviando il campo di intestazione richiesta di autorizzazione con la richiesta. Il campo contiene le credenziali per il dominio richiesto dall'utente.
HttpHeaderCookie Valore: 25 L'intestazione della richiesta cookie contiene dati usati per mantenere lo stato client con il server. I dati dei cookie vengono ottenuti da una risposta inviata con HttpHeaderSetCookie.
HttpHeaderExpect Valore: 26 Indica i comportamenti specifici del server richiesti dal client.
HttpHeaderFrom Valore: 27 Il campo From intestazione specifica l'iniziatore della richiesta SIP o del messaggio di risposta.
HttpHeaderHost Valore: 28 Specifica l'host Internet e il numero di porta della risorsa richiesta. Questa operazione viene ottenuta dall'URI originale specificato dall'utente o dalla risorsa di riferimento.
HttpHeaderIfMatch Valore: 29 Il campo di intestazione della richiesta If-Match viene usato con un metodo per renderlo condizionale. Un client con una o più entità ottenute in precedenza dalla risorsa può verificare che una di queste entità sia corrente includendo un elenco dei tag di entità associati nel campo di intestazione If-Match.
HttpHeaderIfModifiedSince Valore: 30 Il campo di intestazione della richiesta If-Modified-Since viene usato con un metodo per renderlo condizionale. Se la variante richiesta non è stata modificata dopo l'ora specificata in questo campo, un'entità non viene restituita dal server; viene invece restituita una risposta 304 (non modificata) senza alcun corpo del messaggio.
HttpHeaderIfNoneMatch Valore: 31 Il campo if-None-Match request-header viene usato con un metodo per effettuare condizionale. Quando un client ha ottenuto una o più entità da una risorsa, può verificare che nessuno di tali entità sia corrente includendo un elenco dei tag di entità associati nell'oggetto Campo intestazione If-None-Match. Lo scopo di questa funzionalità è consentire aggiornamenti efficienti delle informazioni memorizzate nella cache con una quantità minima di sovraccarico delle transazioni e per evitare un metodo, ad esempio PUT dalla modifica involontaria di una risorsa esistente quando il client ritiene che la risorsa non esista.
HttpHeaderIfRange Valore: 32 Se un client ha una copia parziale di un'entità nella cache e desidera per ottenere una copia aggiornata dell'intera entità, può usare l'intestazione If-Range. In modo informale, il suo significato è " se l'entità è invariata, inviare me le parti che sono mancanti; in caso contrario, inviami l'intero nuovo entità."
HttpHeaderIfUnmodifiedSince Valore: 33 Il campo If-Unmodified-Since request-header viene usato con un metodo per rendere condizionale. Se la risorsa richiesta non è stata modificata dal momento che l'ora specificata in questo campo, il server esegue l'oggetto operazione richiesta come se l'intestazione If-Unmodified-Since non fosse presente, ma se la risorsa richiesta è stata modificata, il server restituisce errore 412 (Precondizione non riuscita).
HttpHeaderMaxForwards Valore: 34 Numero massimo di proxy o gateway che possono inoltrare la richiesta.
HttpHeaderProxyAuthorization Valore: 35 Questo campo di intestazione viene usato dal client per identificarsi con un proxy.
HttpHeaderReferer Valore: 36 Consente al client di specificare, per il vantaggio del server, l'indirizzo (URI) della risorsa da cui è stato ottenuto l'URI richiesta.
HttpHeaderRange Valore: 37 Consente a un client di richiedere una parte di un'entità anziché l'intera.
HttpHeaderTe Valore: 38 Questo campo di intestazione contiene il destinatario della richiesta SIP o del messaggio di risposta.
HttpHeaderTranslate Valore: 39 Consente al client di specificare se desidera la rappresentazione di origine o l'interpretazione programmatica del contenuto richiesto.
HttpHeaderUserAgent Valore: 40 Indica la codifica di trasferimento dell'estensione accettata dal client nella risposta e se il client accetta o meno i campi trailer in una codifica di trasferimento in blocchi.
HttpHeaderRequestMaximum Valore: 41 Non un valore che designa effettivamente un'intestazione; viene invece usato per contare le intestazioni request enumerate.
HttpHeaderAcceptRanges Valore: 20 Consente al server di indicare l'accettazione delle richieste di intervallo per una risorsa.
HttpHeaderAge Valore: 21 Indica la stima del mittente della quantità di tempo trascorsa dalla generazione della risposta (o della riconvalida) nel server di origine.
HttpHeaderEtag Valore: 22 Fornisce il valore corrente del tag di entità per la variante richiesta.
HttpHeaderLocation Valore: 23 Usato per reindirizzare il destinatario a una posizione diversa dall'URI richiesta per il completamento della richiesta o dell'identificazione di una nuova risorsa.
HttpHeaderProxyAuthenticate Valore: 24 Campo di risposta che deve essere incluso come parte della risposta 407. Il campo include lo schema di autenticazione e i parametri che si applicano al proxy per questo URI richiesta.
HttpHeaderRetryAfter Valore: 25 Periodo di tempo per cui si prevede che il servizio non sia disponibile per il client richiedente.
HttpHeaderServer Valore: 26 Si tratta di un campo di intestazione della risposta che contiene informazioni sul server che gestisce la richiesta.
HttpHeaderSetCookie Valore: 27 L'intestazione di risposta set-cookie contiene i dati usati per mantenere lo stato del client nelle richieste future inviate con HttpHeaderCookie.
HttpHeaderVary Valore: 28 Indica il set di campi di intestazione della richiesta che determina completamente, mentre la risposta è aggiornata, se una cache può usare la risposta per rispondere a una richiesta successiva senza riconvalidare.
HttpHeaderWwwAuthenticate Valore: 29 Il campo intestazione WWW_Authenticate contiene gli schemi di autenticazione e i parametri applicabili all'URI richiesta.
HttpHeaderResponseMaximum Valore: 30 Non un valore che designa effettivamente un'intestazione; viene invece usato per contare le intestazioni response enumerate.
HttpHeaderMaximum Valore: 41 Non un valore che designa effettivamente un'intestazione; viene invece usato per contare tutte le intestazioni enumerate.

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_HEADERS

HTTP_RESPONSE_HEADERS