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