constantes Request-Processing
Cette rubrique décrit les constantes définies dans le fichier d’en-tête Httpserv.h.
Constantes de traitement des demandes
Constantes de notification de Request-Level déterministes
Les constantes suivantes sont utilisées avec la méthode IHttpModuleRegistrationInfo::SetRequestNotifications pour spécifier les notifications séquentielles au niveau de la requête qu’un module HTTP traitera.
| Constant | Masque | Description |
|---|---|---|
| RQ_BEGIN_REQUEST | 0x00000001 | Indique qu’IIS a commencé à traiter une demande. |
| RQ_AUTHENTICATE_REQUEST | 0x00000002 | Indique qu’IIS a authentifié une requête. |
| RQ_AUTHORIZE_REQUEST | 0x00000004 | Indique qu’IIS a autorisé une demande. |
| RQ_RESOLVE_REQUEST_CACHE | 0x00000008 | Indique qu’IIS a satisfait une demande provenant du cache. |
| RQ_MAP_REQUEST_HANDLER | 0x00000010 | Indique qu’IIS mappait le gestionnaire pour la demande. |
| RQ_ACQUIRE_REQUEST_STATE | 0x00000020 | Indique qu’IIS a acquis l’état d’une requête. |
| RQ_PRE_EXECUTE_REQUEST_HANDLER | 0x00000040 | Indique qu’IIS exécutera un gestionnaire de requêtes. |
| RQ_EXECUTE_REQUEST_HANDLER | 0x00000080 | Indique qu’IIS a exécuté un gestionnaire de requêtes. |
| RQ_RELEASE_REQUEST_STATE | 0x00000100 | Indique qu’IIS a publié l’état d’une requête. |
| RQ_UPDATE_REQUEST_CACHE | 0x00000200 | Indique qu’IIS a mis à jour le cache. |
| RQ_LOG_REQUEST | 0x00000400 | Indique qu’IIS a enregistré la demande. |
| RQ_END_REQUEST | 0x00000800 | Indique qu’IIS a mis fin à une requête. |
Constantes de notification Request-Level non déterministes
Les constantes suivantes sont utilisées avec la méthode IHttpModuleRegistrationInfo::SetRequestNotifications pour spécifier les notifications de niveau requête non essentielles qu’un module HTTP traitera.
| Constant | Masque | Description |
|---|---|---|
| RQ_CUSTOM_NOTIFICATION | 0x10000000 | Indique qu’une notification personnalisée au niveau de la demande s’est produite. |
| RQ_SEND_RESPONSE | 0x20000000 | Indique qu’IIS a envoyé une réponse. |
| RQ_READ_ENTITY | 0x40000000 | Indique qu’IIS lit les données de l’entité de requête. |
| RQ_MAP_PATH | 0x80000000 | Indique qu’IIS a mappé une URL à un chemin physique. |
Constantes de notification globales
Les constantes suivantes sont utilisées avec la méthode IHttpModuleRegistrationInfo::SetGlobalNotifications pour spécifier les notifications de niveau global qu’un module HTTP traitera.
| Constant | Masque | Description |
|---|---|---|
| GL_STOP_LISTENING | 0x00000002 | Indique qu’IIS a cessé d’accepter de nouvelles demandes. |
| GL_CACHE_CLEANUP | 0x00000004 | Indique qu’IIS a nettoyé le cache. |
| GL_CACHE_OPERATION | 0x00000010 | Indique qu’une opération de cache s’est produite. |
| GL_HEALTH_CHECK | 0x00000020 | Indique qu’une case activée d’intégrité s’est produite. |
| GL_CONFIGURATION_CHANGE | 0x00000040 | Indique que la configuration IIS a changé. |
| GL_FILE_CHANGE | 0x00000080 | Indique qu’un fichier a changé. |
| GL_PRE_BEGIN_REQUEST | 0x00000100 | Indique qu’une demande entre dans le pipeline intégré de traitement des demandes. |
| GL_APPLICATION_START | 0x00000200 | Indique qu’une application a démarré. |
| GL_APPLICATION_RESOLVE_MODULES | 0x00000400 | Indique qu’IIS a résolu les modules d’une application. |
| GL_APPLICATION_STOP | 0x00000800 | Indique qu’une application s’est terminée. |
| GL_RSCA_QUERY | 0x00001000 | Indique qu’une requête d’état et de contrôle Run-Time a été émise. |
| GL_TRACE_EVENT | 0x00002000 | Indique qu’un événement de trace IIS a été déclenché. |
| GL_CUSTOM_NOTIFICATION | 0x00004000 | Indique qu’une notification de niveau global personnalisée s’est produite. |
| GL_THREAD_CLEANUP | 0x00008000 | Indique qu’IIS a nettoyé un thread. |
Constantes d’alias de priorité
Les constantes suivantes sont utilisées avec les méthodes IHttpModuleRegistrationInfo::SetPriorityForRequestNotification et IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification pour spécifier le niveau de priorité pour les notifications.
Notes
Les niveaux de priorité sont inversés pour les RQ_SEND_RESPONSE notifications.
| Constant | Valeur | Description |
|---|---|---|
| PRIORITY_ALIAS_FIRST | L"FIRST » | Indique que le module doit être traité avant tous les autres modules. Pour RQ_SEND_RESPONSE les notifications, indique que le module doit être traité après tous les autres modules. |
| PRIORITY_ALIAS_HIGH | L"HIGH » | Indique que le module doit être traité avec une priorité élevée. Pour RQ_SEND_RESPONSE les notifications, indique que le module doit être traité avec une priorité basse. |
| PRIORITY_ALIAS_MEDIUM | L"MEDIUM » | Indique que le module doit être traité avec une priorité moyenne. |
| PRIORITY_ALIAS_LOW | L"LOW » | Indique que le module doit être traité avec une priorité basse. Pour RQ_SEND_RESPONSE les notifications, indique que le module doit être traité avec une priorité élevée. |
| PRIORITY_ALIAS_LAST | L"LAST » | Indique que le module doit être traité après tous les autres modules. Pour RQ_SEND_RESPONSE les notifications, indique que le module doit être traité avant tous les autres modules. |
constantes Context-Cloning
Les constantes suivantes sont utilisées avec la méthode IHttpContext::CloneContext pour spécifier les sections du contexte qui doivent être clonées.
| Constant | Valeur | Description |
|---|---|---|
| CLONE_FLAG_BASICS | 0x01 | Indique que l’URL, la chaîne de requête et la méthode HTTP doivent être clonées. |
| CLONE_FLAG_HEADERS | 0x02 | Indique que les en-têtes de requête doivent être cloné. |
| CLONE_FLAG_ENTITY | 0x04 | Indique que le corps de l’entité doit être cloné. |
| CLONE_FLAG_NO_PRECONDITION | 0x08 | Indique que les en-têtes « range » et « if- » de la demande ne doivent pas être inclus dans l’opération de clonage. |
| CLONE_FLAG_NO_DAV | 0x10 | Indique que les en-têtes WebDAV de la demande ne doivent pas être inclus dans l’opération de clonage. |
constantes Request-Execution
Les constantes suivantes sont utilisées avec la méthode IHttpContext::ExecuteRequest pour spécifier le comportement d’exécution d’un contexte enfant.
| Constant | Valeur | Description |
|---|---|---|
| EXECUTE_FLAG_NO_HEADERS | 0x01 | Indique que les en-têtes HTTP de la requête enfant doivent être supprimés. |
| EXECUTE_FLAG_IGNORE_CURRENT_INTERCEPTOR | 0x02 | Indique que le gestionnaire de mappage de script actuel pour cette chaîne de requêtes doit être ignoré. |
| EXECUTE_FLAG_IGNORE_APPPOOL | 0x04 | Indique que la requête doit être exécutée, même si la requête enfant ne se trouve pas dans le même pool d’applications. |
| EXECUTE_FLAG_DISABLE_CUSTOM_ERROR | 0x08 | Indique que les erreurs personnalisées pour la requête enfant doivent être désactivées. |
| EXECUTE_FLAG_SAME_URL | 0x10 | Indique que l’URL de la requête enfant est identique à l’URL de la requête parente. |
| EXECUTE_FLAG_BUFFER_RESPONSE | 0x20 | Indique que la réponse enfant doit être retournée à la requête parente et ne doit pas être vidée. |
| EXECUTE_FLAG_HTTP_CACHE_ELIGIBLE | 0x40 | Indique que la réponse enfant est toujours éligible à la mise en cache par Http.sys. |
Voir aussi
Constantes principales du serveur web
Informations de référence sur l’API Web Server Core
IHttpContext::CloneContext, méthode
IHttpContext::ExecuteRequest, méthode
IHttpModuleRegistrationInfo::SetGlobalNotifications, méthode
IHttpModuleRegistrationInfo::SetPriorityForRequestNotification, méthode
IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification, méthode
IHttpModuleRegistrationInfo::SetRequestNotifications, méthode