Constantes Request-Processing
Este tópico descreve as constantes definidas no arquivo de cabeçalho Httpserv.h.
Constantes de processamento de solicitação
Constantes de notificação Request-Level determinísticas
As seguintes constantes são usadas com o método IHttpModuleRegistrationInfo::SetRequestNotifications para especificar quais notificações sequenciais no nível da solicitação um módulo HTTP processará.
| Constante | Bitmask | Descrição |
|---|---|---|
| RQ_BEGIN_REQUEST | 0x00000001 | Indica que o IIS começou a processar uma solicitação. |
| RQ_AUTHENTICATE_REQUEST | 0x00000002 | Indica que o IIS autenticou uma solicitação. |
| RQ_AUTHORIZE_REQUEST | 0x00000004 | Indica que o IIS autorizou uma solicitação. |
| RQ_RESOLVE_REQUEST_CACHE | 0x00000008 | Indica que o IIS atendeu a uma solicitação do cache. |
| RQ_MAP_REQUEST_HANDLER | 0x00000010 | Indica que o IIS mapeou o manipulador para solicitação. |
| RQ_ACQUIRE_REQUEST_STATE | 0x00000020 | Indica que o IIS adquiriu o estado de uma solicitação. |
| RQ_PRE_EXECUTE_REQUEST_HANDLER | 0x00000040 | Indica que o IIS executará um manipulador de solicitação. |
| RQ_EXECUTE_REQUEST_HANDLER | 0x00000080 | Indica que o IIS executou um manipulador de solicitação. |
| RQ_RELEASE_REQUEST_STATE | 0x00000100 | Indica que o IIS liberou o estado de uma solicitação. |
| RQ_UPDATE_REQUEST_CACHE | 0x00000200 | Indica que o IIS atualizou o cache. |
| RQ_LOG_REQUEST | 0x00000400 | Indica que o IIS registrou a solicitação. |
| RQ_END_REQUEST | 0x00000800 | Indica que o IIS encerrou uma solicitação. |
Constantes de notificação de Request-Level não determinísticas
As seguintes constantes são usadas com o método IHttpModuleRegistrationInfo::SetRequestNotifications para especificar quais notificações no nível de solicitação não sequenciais um módulo HTTP processará.
| Constante | Bitmask | Descrição |
|---|---|---|
| RQ_CUSTOM_NOTIFICATION | 0x10000000 | Indica que ocorreu uma notificação personalizada no nível da solicitação. |
| RQ_SEND_RESPONSE | 0x20000000 | Indica que o IIS enviou uma resposta. |
| RQ_READ_ENTITY | 0x40000000 | Indica que o IIS lê dados da entidade de solicitação. |
| RQ_MAP_PATH | 0x80000000 | Indica que o IIS mapeou uma URL para um caminho físico. |
Constantes de notificação global
As seguintes constantes são usadas com o método IHttpModuleRegistrationInfo::SetGlobalNotifications para especificar quais notificações de nível global um módulo HTTP processará.
| Constante | Bitmask | Descrição |
|---|---|---|
| GL_STOP_LISTENING | 0x00000002 | Indica que o IIS parou de aceitar novas solicitações. |
| GL_CACHE_CLEANUP | 0x00000004 | Indica que o IIS limpou o cache. |
| GL_CACHE_OPERATION | 0x00000010 | Indica que ocorreu uma operação de cache. |
| GL_HEALTH_CHECK | 0x00000020 | Indica que ocorreu um marcar de integridade. |
| GL_CONFIGURATION_CHANGE | 0x00000040 | Indica que a configuração do IIS foi alterada. |
| GL_FILE_CHANGE | 0x00000080 | Indica que um arquivo foi alterado. |
| GL_PRE_BEGIN_REQUEST | 0x00000100 | Indica que uma solicitação entrará no pipeline de processamento de solicitação integrado. |
| GL_APPLICATION_START | 0x00000200 | Indica que um aplicativo foi iniciado. |
| GL_APPLICATION_RESOLVE_MODULES | 0x00000400 | Indica que o IIS resolveu os módulos de um aplicativo. |
| GL_APPLICATION_STOP | 0x00000800 | Indica que um aplicativo foi encerrado. |
| GL_RSCA_QUERY | 0x00001000 | Indica que uma consulta de Status e Controle de Run-Time foi emitida. |
| GL_TRACE_EVENT | 0x00002000 | Indica que um evento de rastreamento do IIS foi gerado. |
| GL_CUSTOM_NOTIFICATION | 0x00004000 | Indica que ocorreu uma notificação de nível global personalizada. |
| GL_THREAD_CLEANUP | 0x00008000 | Indica que o IIS limpou um thread. |
Constantes de alias de prioridade
As seguintes constantes são usadas com os métodos IHttpModuleRegistrationInfo::SetPriorityForRequestNotification e IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification para especificar o nível de prioridade para notificações.
Observação
Os níveis de prioridade são invertidos para RQ_SEND_RESPONSE notificações.
| Constante | Valor | Descrição |
|---|---|---|
| PRIORITY_ALIAS_FIRST | L"FIRST" | Indica que o módulo deve ser processado antes de todos os outros módulos. Para RQ_SEND_RESPONSE notificações, indica que o módulo deve ser processado após todos os outros módulos. |
| PRIORITY_ALIAS_HIGH | L"HIGH" | Indica que o módulo deve ser processado com alta prioridade. Para RQ_SEND_RESPONSE notificações, indica que o módulo deve ser processado com baixa prioridade. |
| PRIORITY_ALIAS_MEDIUM | L"MEDIUM" | Indica que o módulo deve ser processado com prioridade média. |
| PRIORITY_ALIAS_LOW | L"LOW" | Indica que o módulo deve ser processado com baixa prioridade. Para RQ_SEND_RESPONSE notificações, indica que o módulo deve ser processado com alta prioridade. |
| PRIORITY_ALIAS_LAST | L"LAST" | Indica que o módulo deve ser processado após todos os outros módulos. Para RQ_SEND_RESPONSE notificações, indica que o módulo deve ser processado antes de todos os outros módulos. |
Constantes Context-Cloning
As seguintes constantes são usadas com o método IHttpContext::CloneContext para especificar quais seções do contexto devem ser clonadas.
| Constante | Valor | Descrição |
|---|---|---|
| CLONE_FLAG_BASICS | 0x01 | Indica que a URL, a cadeia de consulta e o método HTTP devem ser clonados. |
| CLONE_FLAG_HEADERS | 0x02 | Indica que os cabeçalhos de solicitação devem ser clonados. |
| CLONE_FLAG_ENTITY | 0x04 | Indica que o corpo da entidade deve ser clonado. |
| CLONE_FLAG_NO_PRECONDITION | 0x08 | Indica que quaisquer cabeçalhos "range" e "if-" para a solicitação não devem ser incluídos na operação de clone. |
| CLONE_FLAG_NO_DAV | 0x10 | Indica que quaisquer cabeçalhos WebDAV para a solicitação não devem ser incluídos na operação de clone. |
Constantes Request-Execution
As seguintes constantes são usadas com o método IHttpContext::ExecuteRequest para especificar o comportamento de execução para um contexto filho.
| Constante | Valor | Descrição |
|---|---|---|
| EXECUTE_FLAG_NO_HEADERS | 0x01 | Indica que os cabeçalhos HTTP para a solicitação filho devem ser suprimidos. |
| EXECUTE_FLAG_IGNORE_CURRENT_INTERCEPTOR | 0x02 | Indica que o manipulador de mapa de script atual para essa cadeia de solicitações deve ser ignorado. |
| EXECUTE_FLAG_IGNORE_APPPOOL | 0x04 | Indica que a solicitação deve ser executada, mesmo que a solicitação filho não esteja no mesmo pool de aplicativos. |
| EXECUTE_FLAG_DISABLE_CUSTOM_ERROR | 0x08 | Indica que os erros personalizados para a solicitação filho devem ser desabilitados. |
| EXECUTE_FLAG_SAME_URL | 0x10 | Indica que a URL da solicitação filho é a mesma que a URL da solicitação pai. |
| EXECUTE_FLAG_BUFFER_RESPONSE | 0x20 | Indica que a resposta filho deve ser retornada à solicitação pai e não ser liberada. |
| EXECUTE_FLAG_HTTP_CACHE_ELIGIBLE | 0x40 | Indica que a resposta filho ainda está qualificada para cache Http.sys. |
Consulte Também
Constantes do Núcleo do Servidor Web
Referência de API Do Web Server Core
Método IHttpContext::CloneContext
Método IHttpContext::ExecuteRequest
Método IHttpModuleRegistrationInfo::SetGlobalNotifications
Método IHttpModuleRegistrationInfo::SetPriorityForRequestNotification
Método IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification
Método IHttpModuleRegistrationInfo::SetRequestNotifications