Request-Processing Constants

IIS 7.0
 

This topic describes the constants that are defined in the Httpserv.h header file.

Deterministic Request-Level Notification Constants

The following constants are used with the IHttpModuleRegistrationInfo::SetRequestNotifications method to specify which sequential request-level notifications an HTTP module will process.

ConstantBitmaskDescription
RQ_BEGIN_REQUEST0x00000001Indicates that IIS began processing a request.
RQ_AUTHENTICATE_REQUEST0x00000002Indicates that IIS authenticated a request.
RQ_AUTHORIZE_REQUEST0x00000004Indicates that IIS authorized a request.
RQ_RESOLVE_REQUEST_CACHE0x00000008Indicates that IIS satisfied a request from the cache.
RQ_MAP_REQUEST_HANDLER0x00000010Indicates that IIS mapped the handler for request.
RQ_ACQUIRE_REQUEST_STATE0x00000020Indicates that IIS acquired the state for a request.
RQ_PRE_EXECUTE_REQUEST_HANDLER0x00000040Indicates that IIS will execute a request handler.
RQ_EXECUTE_REQUEST_HANDLER0x00000080Indicates that IIS executed a request handler.
RQ_RELEASE_REQUEST_STATE0x00000100Indicates that IIS released the state for a request.
RQ_UPDATE_REQUEST_CACHE0x00000200Indicates that IIS updated the cache.
RQ_LOG_REQUEST0x00000400Indicates that IIS logged the request.
RQ_END_REQUEST0x00000800Indicates that IIS ended a request.

Nondeterministic Request-Level Notification Constants

The following constants are used with the IHttpModuleRegistrationInfo::SetRequestNotifications method to specify which nonsequential request-level notifications an HTTP module will process.

ConstantBitmaskDescription
RQ_CUSTOM_NOTIFICATION0x10000000Indicates that a custom request-level notification occurred.
RQ_SEND_RESPONSE0x20000000Indicates that IIS sent a response.
RQ_READ_ENTITY0x40000000Indicates that IIS read data from the request entity.
RQ_MAP_PATH0x80000000Indicates that IIS mapped a URL to a physical path.

Global Notification Constants

The following constants are used with the IHttpModuleRegistrationInfo::SetGlobalNotifications method to specify which global-level notifications an HTTP module will process.

ConstantBitmaskDescription
GL_STOP_LISTENING0x00000002Indicates that IIS stopped accepting new requests.
GL_CACHE_CLEANUP0x00000004Indicates that IIS cleaned up the cache.
GL_CACHE_OPERATION0x00000010Indicates that a cache operation occurred.
GL_HEALTH_CHECK0x00000020Indicates that a health check occurred.
GL_CONFIGURATION_CHANGE0x00000040Indicates that the IIS configuration changed.
GL_FILE_CHANGE0x00000080Indicates that a file changed.
GL_PRE_BEGIN_REQUEST0x00000100Indicates that a request will enter the integrated request-processing pipeline.
GL_APPLICATION_START0x00000200Indicates that an application started.
GL_APPLICATION_RESOLVE_MODULES0x00000400Indicates that IIS resolved the modules for an application.
GL_APPLICATION_STOP0x00000800Indicates that an application exited.
GL_RSCA_QUERY0x00001000Indicates that a Run-Time Status and Control query was issued.
GL_TRACE_EVENT0x00002000Indicates that an IIS trace event was raised.
GL_CUSTOM_NOTIFICATION0x00004000Indicates that a custom global-level notification occurred.
GL_THREAD_CLEANUP0x00008000Indicates that IIS cleaned up a thread.

Priority Alias Constants

The following constants are used with the IHttpModuleRegistrationInfo::SetPriorityForRequestNotification and IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification methods to specify the priority level for notifications.

System_CAPS_ICON_note.jpg Note

The priority levels are inverted for RQ_SEND_RESPONSE notifications.

ConstantValueDescription
PRIORITY_ALIAS_FIRSTL"FIRST"Indicates that the module should be processed before all other modules. For RQ_SEND_RESPONSE notifications, indicates that the module should be processed after all other modules.
PRIORITY_ALIAS_HIGHL"HIGH"Indicates that the module should be processed with high priority. For RQ_SEND_RESPONSE notifications, indicates that the module should be processed with low priority.
PRIORITY_ALIAS_MEDIUML"MEDIUM"Indicates that the module should be processed with medium priority.
PRIORITY_ALIAS_LOWL"LOW"Indicates that the module should be processed with low priority. For RQ_SEND_RESPONSE notifications, indicates that the module should be processed with high priority.
PRIORITY_ALIAS_LASTL"LAST"Indicates that the module should be processed after all other modules. For RQ_SEND_RESPONSE notifications, indicates that the module should be processed before all other modules.

Context-Cloning Constants

The following constants are used with the IHttpContext::CloneContext method to specify which sections of the context should be cloned.

ConstantValueDescription
CLONE_FLAG_BASICS0x01Indicates that the URL, query string, and HTTP method should be cloned.
CLONE_FLAG_HEADERS0x02Indicates that the request headers should be cloned.
CLONE_FLAG_ENTITY0x04Indicates that the entity body should be cloned.
CLONE_FLAG_NO_PRECONDITION0x08Indicates that any "range" and "if-" headers for the request should not be included in the clone operation.
CLONE_FLAG_NO_DAV0x10Indicates that any WebDAV headers for the request should not be included in the clone operation.

Request-Execution Constants

The following constants are used with the IHttpContext::ExecuteRequest method to specify the execution behavior for a child context.

ConstantValueDescription
EXECUTE_FLAG_NO_HEADERS0x01Indicates that the HTTP headers for the child request should be suppressed.
EXECUTE_FLAG_IGNORE_CURRENT_INTERCEPTOR0x02Indicates that the current script map handler for this request chain should be ignored.
EXECUTE_FLAG_IGNORE_APPPOOL0x04Indicates that the request should be executed, even if the child request is not in the same application pool.
EXECUTE_FLAG_DISABLE_CUSTOM_ERROR0x08Indicates that the custom errors for the child request should be disabled.
EXECUTE_FLAG_SAME_URL0x10Indicates that the URL for the child request is the same as the URL for the parent request.
EXECUTE_FLAG_BUFFER_RESPONSE0x20Indicates that the child response should be returned to the parent request and not be flushed.
EXECUTE_FLAG_HTTP_CACHE_ELIGIBLE0x40Indicates that the child response is still eligible for caching by Http.sys.

Web Server Core Constants
Web Server Core API Reference
IHttpContext::CloneContext Method
IHttpContext::ExecuteRequest Method
IHttpModuleRegistrationInfo::SetGlobalNotifications Method
IHttpModuleRegistrationInfo::SetPriorityForRequestNotification Method
IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification Method
IHttpModuleRegistrationInfo::SetRequestNotifications Method

Show: