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 メソッド