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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour