costanti Request-Processing

In questo argomento vengono descritte le costanti definite nel file di intestazione Httpserv.h.

Costanti di elaborazione delle richieste

Le costanti seguenti vengono usate con il metodo IHttpModuleRegistrationInfo::SetRequestNotifications per specificare le notifiche a livello di richiesta sequenziale elaborate da un modulo HTTP.

Costante	Maschera	Descrizione
RQ_BEGIN_REQUEST	0x00000001	Indica che IIS ha iniziato a elaborare una richiesta.
RQ_AUTHENTICATE_REQUEST	0x00000002	Indica che IIS ha autenticato una richiesta.
RQ_AUTHORIZE_REQUEST	0x00000004	Indica che IIS ha autorizzato una richiesta.
RQ_RESOLVE_REQUEST_CACHE	0x00000008	Indica che IIS ha soddisfatto una richiesta dalla cache.
RQ_MAP_REQUEST_HANDLER	0x00000010	Indica che IIS ha eseguito il mapping del gestore per la richiesta.
RQ_ACQUIRE_REQUEST_STATE	0x00000020	Indica che IIS ha acquisito lo stato per una richiesta.
RQ_PRE_EXECUTE_REQUEST_HANDLER	0x00000040	Indica che IIS eseguirà un gestore di richiesta.
RQ_EXECUTE_REQUEST_HANDLER	0x00000080	Indica che IIS ha eseguito un gestore di richiesta.
RQ_RELEASE_REQUEST_STATE	0x00000100	Indica che IIS ha rilasciato lo stato per una richiesta.
RQ_UPDATE_REQUEST_CACHE	0x00000200	Indica che IIS ha aggiornato la cache.
RQ_LOG_REQUEST	0x00000400	Indica che IIS ha registrato la richiesta.
RQ_END_REQUEST	0x00000800	Indica che IIS ha terminato una richiesta.

Le costanti seguenti vengono usate con il metodo IHttpModuleRegistrationInfo::SetRequestNotifications per specificare le notifiche a livello di richiesta non sequenziali elaborate da un modulo HTTP.

Costante	Maschera	Descrizione
RQ_CUSTOM_NOTIFICATION	0x10000000	Indica che si è verificata una notifica a livello di richiesta personalizzata.
RQ_SEND_RESPONSE	0x20000000	Indica che IIS ha inviato una risposta.
RQ_READ_ENTITY	0x40000000	Indica che IIS legge i dati dall'entità richiesta.
RQ_MAP_PATH	0x80000000	Indica che IIS ha eseguito il mapping di un URL a un percorso fisico.

Le costanti seguenti vengono usate con il metodo IHttpModuleRegistrationInfo::SetGlobalNotifications per specificare quali notifiche a livello globale verrà elaborato un modulo HTTP.

Costante	Maschera	Descrizione
GL_STOP_LISTENING	0x00000002	Indica che IIS ha arrestato l'accettazione di nuove richieste.
GL_CACHE_CLEANUP	0x00000004	Indica che IIS ha pulito la cache.
GL_CACHE_OPERATION	0x00000010	Indica che si è verificata un'operazione della cache.
GL_HEALTH_CHECK	0x00000020	Indica che si è verificato un controllo di integrità.
GL_CONFIGURATION_CHANGE	0x00000040	Indica che la configurazione IIS è stata modificata.
GL_FILE_CHANGE	0x00000080	Indica che un file è stato modificato.
GL_PRE_BEGIN_REQUEST	0x00000100	Indica che una richiesta immetterà la pipeline integrata di elaborazione delle richieste.
GL_APPLICATION_START	0x00000200	Indica che un'applicazione è stata avviata.
GL_APPLICATION_RESOLVE_MODULES	0x00000400	Indica che IIS ha risolto i moduli per un'applicazione.
GL_APPLICATION_STOP	0x00000800	Indica che un'applicazione è stata chiusa.
GL_RSCA_QUERY	0x00001000	Indica che è stata eseguita una query di stato e controllo Run-Time.
GL_TRACE_EVENT	0x00002000	Indica che è stato generato un evento di traccia IIS.
GL_CUSTOM_NOTIFICATION	0x00004000	Indica che si è verificata una notifica a livello globale personalizzata.
GL_THREAD_CLEANUP	0x00008000	Indica che IIS ha pulito un thread.

Nota

I livelli di priorità vengono invertiti per RQ_SEND_RESPONSE le notifiche.

Costante	Valore	Descrizione
PRIORITY_ALIAS_FIRST	L"FIRST"	Indica che il modulo deve essere elaborato prima di tutti gli altri moduli. Per `RQ_SEND_RESPONSE` le notifiche, indica che il modulo deve essere elaborato dopo tutti gli altri moduli.
PRIORITY_ALIAS_HIGH	L"HIGH"	Indica che il modulo deve essere elaborato con priorità alta. Per `RQ_SEND_RESPONSE` le notifiche, indica che il modulo deve essere elaborato con priorità bassa.
PRIORITY_ALIAS_MEDIUM	L"MEDIUM"	Indica che il modulo deve essere elaborato con priorità media.
PRIORITY_ALIAS_LOW	L"LOW"	Indica che il modulo deve essere elaborato con priorità bassa. Per `RQ_SEND_RESPONSE` le notifiche, indica che il modulo deve essere elaborato con priorità elevata.
PRIORITY_ALIAS_LAST	L"LAST"	Indica che il modulo deve essere elaborato dopo tutti gli altri moduli. Per `RQ_SEND_RESPONSE` le notifiche, indica che il modulo deve essere elaborato prima di tutti gli altri moduli.

Le costanti seguenti vengono utilizzate con il metodo IHttpContext::CloneContext per specificare le sezioni del contesto da clonare.

Costante	Valore	Descrizione
CLONE_FLAG_BASICS	0x01	Indica che l'URL, la stringa di query e il metodo HTTP devono essere clonati.
CLONE_FLAG_HEADERS	0x02	Indica che le intestazioni della richiesta devono essere clonate.
CLONE_FLAG_ENTITY	0x04	Indica che il corpo dell'entità deve essere clonato.
CLONE_FLAG_NO_PRECONDITION	0x08	Indica che le intestazioni "range" e "if-" per la richiesta non devono essere incluse nell'operazione di clonazione.
CLONE_FLAG_NO_DAV	0x10	Indica che le intestazioni WebDAV per la richiesta non devono essere incluse nell'operazione di clonazione.

Le costanti seguenti vengono usate con il metodo IHttpContext::ExecuteRequest per specificare il comportamento di esecuzione per un contesto figlio.

Costante	Valore	Descrizione
EXECUTE_FLAG_NO_HEADERS	0x01	Indica che le intestazioni HTTP per la richiesta figlio devono essere eliminate.
EXECUTE_FLAG_IGNORE_CURRENT_INTERCEPTOR	0x02	Indica che il gestore della mappa di script corrente per questa catena di richieste deve essere ignorato.
EXECUTE_FLAG_IGNORE_APPPOOL	0x04	Indica che la richiesta deve essere eseguita, anche se la richiesta figlio non si trova nello stesso pool di applicazioni.
EXECUTE_FLAG_DISABLE_CUSTOM_ERROR	0x08	Indica che gli errori personalizzati per la richiesta figlio devono essere disabilitati.
EXECUTE_FLAG_SAME_URL	0x10	Indica che l'URL della richiesta figlio corrisponde all'URL della richiesta padre.
EXECUTE_FLAG_BUFFER_RESPONSE	0x20	Indica che la risposta figlio deve essere restituita alla richiesta padre e non deve essere scaricata.
EXECUTE_FLAG_HTTP_CACHE_ELIGIBLE	0x40	Indica che la risposta figlio è ancora idonea per la memorizzazione nella cache Http.sys.