Request-Processing常數
本主題描述 Httpserv.h 標頭檔中定義的常數。
要求處理常數
具決定性Request-Level通知常數
下列常數會與 IHttpModuleRegistrationInfo::SetRequestNotifications 方法搭配使用,以指定 HTTP 模組將處理的循序要求層級通知。
常數 | 位元遮罩 | 描述 |
---|---|---|
RQ_BEGIN_REQUEST | 0x00000001 | 表示 IIS 已開始處理要求。 |
RQ_AUTHENTICATE_REQUEST | 0x00000002 | 表示 IIS 已驗證要求。 |
RQ_AUTHORIZE_REQUEST | 0x00000004 | 表示 IIS 已授權要求。 |
RQ_RESOLVE_REQUEST_CACHE | 0x00000008 | 表示 IIS 已滿足快取的要求。 |
RQ_MAP_REQUEST_HANDLER | 0x00000010 | 指出 IIS 已對應要求的處理常式。 |
RQ_ACQUIRE_REQUEST_STATE | 0x00000020 | 指出 IIS 已取得要求的狀態。 |
RQ_PRE_EXECUTE_REQUEST_HANDLER | 0x00000040 | 指出 IIS 會執行要求處理常式。 |
RQ_EXECUTE_REQUEST_HANDLER | 0x00000080 | 表示 IIS 執行要求處理常式。 |
RQ_RELEASE_REQUEST_STATE | 0x00000100 | 表示 IIS 已釋放要求的狀態。 |
RQ_UPDATE_REQUEST_CACHE | 0x00000200 | 指出 IIS 已更新快取。 |
RQ_LOG_REQUEST | 0x00000400 | 指出 IIS 記錄了要求。 |
RQ_END_REQUEST | 0x00000800 | 表示 IIS 已結束要求。 |
非決定性Request-Level通知常數
下列常數會與 IHttpModuleRegistrationInfo::SetRequestNotifications 方法搭配使用,以指定 HTTP 模組將處理的非查詢層級通知。
常數 | 位元遮罩 | 描述 |
---|---|---|
RQ_CUSTOM_NOTIFICATION | 0x10000000 | 表示發生自訂要求層級通知。 |
RQ_SEND_RESPONSE | 0x20000000 | 指出 IIS 已傳送回應。 |
RQ_READ_ENTITY | 0x40000000 | 指出 IIS 會從要求實體讀取資料。 |
RQ_MAP_PATH | 0x80000000 | 表示 IIS 已將 URL 對應至實體路徑。 |
全域通知常數
下列常數會與 IHttpModuleRegistrationInfo::SetGlobalNotifications 方法搭配使用,以指定 HTTP 模組將處理的全域層級通知。
常數 | 位元遮罩 | 描述 |
---|---|---|
GL_STOP_LISTENING | 0x00000002 | 表示 IIS 已停止接受新的要求。 |
GL_CACHE_CLEANUP | 0x00000004 | 表示 IIS 已清除快取。 |
GL_CACHE_OPERATION | 0x00000010 | 表示發生快取作業。 |
GL_HEALTH_CHECK | 0x00000020 | 表示發生健康情況檢查。 |
GL_CONFIGURATION_CHANGE | 0x00000040 | 表示 IIS 組態已變更。 |
GL_FILE_CHANGE | 0x00000080 | 表示檔案已變更。 |
GL_PRE_BEGIN_REQUEST | 0x00000100 | 表示要求會進入整合式要求處理管線。 |
GL_APPLICATION_START | 0x00000200 | 表示應用程式已啟動。 |
GL_APPLICATION_RESOLVE_MODULES | 0x00000400 | 指出 IIS 已解析應用程式的模組。 |
GL_APPLICATION_STOP | 0x00000800 | 表示應用程式已結束。 |
GL_RSCA_QUERY | 0x00001000 | 表示已發出Run-Time狀態和控制項查詢。 |
GL_TRACE_EVENT | 0x00002000 | 表示已引發 IIS 追蹤事件。 |
GL_CUSTOM_NOTIFICATION | 0x00004000 | 表示發生自訂全域層級通知。 |
GL_THREAD_CLEANUP | 0x00008000 | 表示 IIS 已清除執行緒。 |
優先順序別名常數
下列常數會與 IHttpModuleRegistrationInfo::SetPriorityForRequestNotification 和 IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification 方法搭配使用,以指定通知的優先順序層級。
注意
通知的優先順序層級會反轉 RQ_SEND_RESPONSE
。
常數 | 值 | 描述 |
---|---|---|
PRIORITY_ALIAS_FIRST | L「FIRST」 | 表示應該在所有其他模組之前處理模組。 針對 RQ_SEND_RESPONSE 通知,表示應該在所有其他模組之後處理模組。 |
PRIORITY_ALIAS_HIGH | L「HIGH」 | 表示應該以高優先順序處理模組。 針對 RQ_SEND_RESPONSE 通知,表示應該以低優先順序處理模組。 |
PRIORITY_ALIAS_MEDIUM | L「MEDIUM」 | 表示模組應該以中優先順序處理。 |
PRIORITY_ALIAS_LOW | L「LOW」 | 表示應該以低優先順序處理模組。 針對 RQ_SEND_RESPONSE 通知,表示應該以高優先順序處理模組。 |
PRIORITY_ALIAS_LAST | L「LAST」 | 表示應該在所有其他模組之後處理模組。 針對 RQ_SEND_RESPONSE 通知,表示應該在所有其他模組之前處理模組。 |
Context-Cloning常數
下列常數會與 IHttpCoNtext::CloneCoNtext 方法搭配使用,以指定應該複製的內容區段。
常數 | 值 | 描述 |
---|---|---|
CLONE_FLAG_BASICS | 0x01 | 表示應該複製 URL、查詢字串和 HTTP 方法。 |
CLONE_FLAG_HEADERS | 0x02 | 表示應該複製要求標頭。 |
CLONE_FLAG_ENTITY | 0x04 | 表示應該複製實體主體。 |
CLONE_FLAG_NO_PRECONDITION | 0x08 | 表示要求的任何「range」 和 「if-」 標頭不應包含在複製作業中。 |
CLONE_FLAG_NO_DAV | 0x10 | 表示要求的任何 WebDAV 標頭不應包含在複製作業中。 |
Request-Execution常數
下列常數會與 IHttpCoNtext::ExecuteRequest 方法搭配使用,以指定子內容的執行行為。
常數 | 值 | 描述 |
---|---|---|
EXECUTE_FLAG_NO_HEADERS | 0x01 | 表示應該隱藏子要求的 HTTP 標頭。 |
EXECUTE_FLAG_IGNORE_CURRENT_INTERCEPTOR | 0x02 | 表示應該忽略此要求鏈結的目前腳本對應處理常式。 |
EXECUTE_FLAG_IGNORE_APPPOOL | 0x04 | 表示應該執行要求,即使子要求不在相同的應用程式集區中也一樣。 |
EXECUTE_FLAG_DISABLE_CUSTOM_ERROR | 0x08 | 表示應該停用子要求的自訂錯誤。 |
EXECUTE_FLAG_SAME_URL | 0x10 | 表示子要求的 URL 與父要求的 URL 相同。 |
EXECUTE_FLAG_BUFFER_RESPONSE | 0x20 | 表示子回應應該傳回父要求,而不會排清。 |
EXECUTE_FLAG_HTTP_CACHE_ELIGIBLE | 0x40 | 表示子回應仍然符合Http.sys快取的資格。 |
另請參閱
Web Server Core 常數
Web Server Core API 參考
IHttpCoNtext::CloneCoNtext 方法
IHttpCoNtext::ExecuteRequest 方法
IHttpModuleRegistrationInfo::SetGlobalNotifications 方法
IHttpModuleRegistrationInfo::SetPriorityForRequestNotification 方法
IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification 方法
IHttpModuleRegistrationInfo::SetRequestNotifications 方法