Partager via


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