constantes de Request-Processing
En este tema se describen las constantes definidas en el archivo de encabezado Httpserv.h.
Constantes de procesamiento de solicitudes
Constantes de notificación de Request-Level deterministas
Las constantes siguientes se usan con el método IHttpModuleRegistrationInfo::SetRequestNotifications para especificar qué notificaciones secuenciales de nivel de solicitud procesará un módulo HTTP.
| Constante | Máscara | Descripción |
|---|---|---|
| RQ_BEGIN_REQUEST | 0x00000001 | Indica que IIS comenzó a procesar una solicitud. |
| RQ_AUTHENTICATE_REQUEST | 0x00000002 | Indica que IIS ha autenticado una solicitud. |
| RQ_AUTHORIZE_REQUEST | 0x00000004 | Indica que IIS autorizó una solicitud. |
| RQ_RESOLVE_REQUEST_CACHE | 0x00000008 | Indica que IIS cumplió una solicitud de la memoria caché. |
| RQ_MAP_REQUEST_HANDLER | 0x00000010 | Indica que IIS ha asignado el controlador para la solicitud. |
| RQ_ACQUIRE_REQUEST_STATE | 0x00000020 | Indica que IIS adquirió el estado de una solicitud. |
| RQ_PRE_EXECUTE_REQUEST_HANDLER | 0x00000040 | Indica que IIS ejecutará un controlador de solicitudes. |
| RQ_EXECUTE_REQUEST_HANDLER | 0x00000080 | Indica que IIS ejecutó un controlador de solicitudes. |
| RQ_RELEASE_REQUEST_STATE | 0x00000100 | Indica que IIS liberó el estado de una solicitud. |
| RQ_UPDATE_REQUEST_CACHE | 0x00000200 | Indica que IIS actualizó la memoria caché. |
| RQ_LOG_REQUEST | 0x00000400 | Indica que IIS registró la solicitud. |
| RQ_END_REQUEST | 0x00000800 | Indica que IIS finalizó una solicitud. |
Constantes de notificación de Request-Level no deterministas
Las siguientes constantes se usan con el método IHttpModuleRegistrationInfo::SetRequestNotifications para especificar qué notificaciones de nivel de solicitud no secuencial procesará un módulo HTTP.
| Constante | Máscara | Descripción |
|---|---|---|
| RQ_CUSTOM_NOTIFICATION | 0x10000000 | Indica que se ha producido una notificación de nivel de solicitud personalizada. |
| RQ_SEND_RESPONSE | 0x20000000 | Indica que IIS envió una respuesta. |
| RQ_READ_ENTITY | 0x40000000 | Indica que IIS lee datos de la entidad de solicitud. |
| RQ_MAP_PATH | 0x80000000 | Indica que IIS asignó una dirección URL a una ruta de acceso física. |
Constantes de notificación globales
Las siguientes constantes se usan con el método IHttpModuleRegistrationInfo::SetGlobalNotifications para especificar qué notificaciones de nivel global procesará un módulo HTTP.
| Constante | Máscara | Descripción |
|---|---|---|
| GL_STOP_LISTENING | 0x00000002 | Indica que IIS dejó de aceptar nuevas solicitudes. |
| GL_CACHE_CLEANUP | 0x00000004 | Indica que IIS ha limpiado la memoria caché. |
| GL_CACHE_OPERATION | 0x00000010 | Indica que se ha producido una operación de caché. |
| GL_HEALTH_CHECK | 0x00000020 | Indica que se ha producido una comprobación de estado. |
| GL_CONFIGURATION_CHANGE | 0x00000040 | Indica que ha cambiado la configuración de IIS. |
| GL_FILE_CHANGE | 0x00000080 | Indica que ha cambiado un archivo. |
| GL_PRE_BEGIN_REQUEST | 0x00000100 | Indica que una solicitud entrará en la canalización integrada de procesamiento de solicitudes. |
| GL_APPLICATION_START | 0x00000200 | Indica que se inició una aplicación. |
| GL_APPLICATION_RESOLVE_MODULES | 0x00000400 | Indica que IIS resolvió los módulos de una aplicación. |
| GL_APPLICATION_STOP | 0x00000800 | Indica que se ha cerrado una aplicación. |
| GL_RSCA_QUERY | 0x00001000 | Indica que se emitió una consulta de estado y control de Run-Time. |
| GL_TRACE_EVENT | 0x00002000 | Indica que se ha generado un evento de seguimiento de IIS. |
| GL_CUSTOM_NOTIFICATION | 0x00004000 | Indica que se ha producido una notificación de nivel global personalizada. |
| GL_THREAD_CLEANUP | 0x00008000 | Indica que IIS ha limpiado un subproceso. |
Constantes de alias de prioridad
Las siguientes constantes se usan con los métodos IHttpModuleRegistrationInfo::SetPriorityForRequestNotification e IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification para especificar el nivel de prioridad para las notificaciones.
Nota
Los niveles de prioridad se invierten para RQ_SEND_RESPONSE las notificaciones.
| Constante | Value | Descripción |
|---|---|---|
| PRIORITY_ALIAS_FIRST | L"FIRST" | Indica que el módulo se debe procesar antes de todos los demás módulos. En RQ_SEND_RESPONSE el caso de las notificaciones, indica que el módulo se debe procesar después de todos los demás módulos. |
| PRIORITY_ALIAS_HIGH | L"HIGH" | Indica que el módulo debe procesarse con prioridad alta. En RQ_SEND_RESPONSE el caso de las notificaciones, indica que el módulo debe procesarse con prioridad baja. |
| PRIORITY_ALIAS_MEDIUM | L"MEDIUM" | Indica que el módulo debe procesarse con prioridad media. |
| PRIORITY_ALIAS_LOW | L"LOW" | Indica que el módulo debe procesarse con prioridad baja. En RQ_SEND_RESPONSE el caso de las notificaciones, indica que el módulo debe procesarse con prioridad alta. |
| PRIORITY_ALIAS_LAST | L"LAST" | Indica que el módulo se debe procesar después de todos los demás módulos. En RQ_SEND_RESPONSE el caso de las notificaciones, indica que el módulo debe procesarse antes de todos los demás módulos. |
constantes de Context-Cloning
Las constantes siguientes se usan con el método IHttpContext::CloneContext para especificar qué secciones del contexto se deben clonar.
| Constante | Value | Descripción |
|---|---|---|
| CLONE_FLAG_BASICS | 0x01 | Indica que se debe clonar la dirección URL, la cadena de consulta y el método HTTP. |
| CLONE_FLAG_HEADERS | 0x02 | Indica que se deben clonar los encabezados de solicitud. |
| CLONE_FLAG_ENTITY | 0x04 | Indica que se debe clonar el cuerpo de la entidad. |
| CLONE_FLAG_NO_PRECONDITION | 0x08 | Indica que los encabezados "range" y "if-" de la solicitud no deben incluirse en la operación de clonación. |
| CLONE_FLAG_NO_DAV | 0x10 | Indica que los encabezados webDAV de la solicitud no deben incluirse en la operación de clonación. |
constantes de Request-Execution
Las constantes siguientes se usan con el método IHttpContext::ExecuteRequest para especificar el comportamiento de ejecución de un contexto secundario.
| Constante | Value | Descripción |
|---|---|---|
| EXECUTE_FLAG_NO_HEADERS | 0x01 | Indica que se deben suprimir los encabezados HTTP de la solicitud secundaria. |
| EXECUTE_FLAG_IGNORE_CURRENT_INTERCEPTOR | 0x02 | Indica que se debe omitir el controlador de mapa de scripts actual para esta cadena de solicitudes. |
| EXECUTE_FLAG_IGNORE_APPPOOL | 0x04 | Indica que se debe ejecutar la solicitud, incluso si la solicitud secundaria no está en el mismo grupo de aplicaciones. |
| EXECUTE_FLAG_DISABLE_CUSTOM_ERROR | 0x08 | Indica que los errores personalizados de la solicitud secundaria deben deshabilitarse. |
| EXECUTE_FLAG_SAME_URL | 0x10 | Indica que la dirección URL de la solicitud secundaria es la misma que la dirección URL de la solicitud primaria. |
| EXECUTE_FLAG_BUFFER_RESPONSE | 0x20 | Indica que la respuesta secundaria se debe devolver a la solicitud primaria y no se vacia. |
| EXECUTE_FLAG_HTTP_CACHE_ELIGIBLE | 0x40 | Indica que la respuesta secundaria sigue siendo apta para el almacenamiento en caché por Http.sys. |
Consulte también
Constantes de Web Server Core
Referencia de API de Web Server Core
IHttpContext::CloneContext (Método)
IHttpContext::ExecuteRequest (Método)
IHttpModuleRegistrationInfo::SetGlobalNotifications (Método)
IHttpModuleRegistrationInfo::SetPriorityForRequestNotification (Método)
IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification (Método)
IHttpModuleRegistrationInfo::SetRequestNotifications (Método)