Request-Processing Konstanten
In diesem Thema werden die Konstanten beschrieben, die in der Httpserv.h-Headerdatei definiert sind.
Anforderungsverarbeitungskonstanten
Deterministische Request-Level Benachrichtigungskonstanten
Die folgenden Konstanten werden mit der IHttpModuleRegistrationInfo::SetRequestNotifications-Methode verwendet, um anzugeben, welche sequenziellen Benachrichtigungen auf Anforderungsebene ein HTTP-Modul verarbeitet.
| Dauerhaft | Bitmaske | BESCHREIBUNG |
|---|---|---|
| RQ_BEGIN_REQUEST | 0x00000001 | Gibt an, dass IIS mit der Verarbeitung einer Anforderung begonnen hat. |
| RQ_AUTHENTICATE_REQUEST | 0x00000002 | Gibt an, dass IIS eine Anforderung authentifiziert hat. |
| RQ_AUTHORIZE_REQUEST | 0x00000004 | Gibt an, dass IIS eine Anforderung autorisiert hat. |
| RQ_RESOLVE_REQUEST_CACHE | 0x00000008 | Gibt an, dass IIS eine Anforderung aus dem Cache erfüllt hat. |
| RQ_MAP_REQUEST_HANDLER | 0x00000010 | Gibt an, dass IIS den Handler für die Anforderung zugeordnet hat. |
| RQ_ACQUIRE_REQUEST_STATE | 0x00000020 | Gibt an, dass IIS den Status für eine Anforderung erworben hat. |
| RQ_PRE_EXECUTE_REQUEST_HANDLER | 0x00000040 | Gibt an, dass IIS einen Anforderungshandler ausführt. |
| RQ_EXECUTE_REQUEST_HANDLER | 0x00000080 | Gibt an, dass IIS einen Anforderungshandler ausgeführt hat. |
| RQ_RELEASE_REQUEST_STATE | 0x00000100 | Gibt an, dass IIS den Status für eine Anforderung freigegeben hat. |
| RQ_UPDATE_REQUEST_CACHE | 0x00000200 | Gibt an, dass IIS den Cache aktualisiert hat. |
| RQ_LOG_REQUEST | 0x00000400 | Gibt an, dass IIS die Anforderung protokolliert hat. |
| RQ_END_REQUEST | 0x00000800 | Gibt an, dass IIS eine Anforderung beendet hat. |
Nichtdeterministische Request-Level Benachrichtigungskonstanten
Die folgenden Konstanten werden mit der IHttpModuleRegistrationInfo::SetRequestNotifications-Methode verwendet, um anzugeben, welche nichtsequentialen Benachrichtigungen auf Anforderungsebene ein HTTP-Modul verarbeitet.
| Dauerhaft | Bitmaske | BESCHREIBUNG |
|---|---|---|
| RQ_CUSTOM_NOTIFICATION | 0x10000000 | Gibt an, dass eine benutzerdefinierte Benachrichtigung auf Anforderungsebene aufgetreten ist. |
| RQ_SEND_RESPONSE | 0x20000000 | Gibt an, dass IIS eine Antwort gesendet hat. |
| RQ_READ_ENTITY | 0x40000000 | Gibt an, dass IIS Daten aus der Anforderungsentität liest. |
| RQ_MAP_PATH | 0x80000000 | Gibt an, dass IIS eine URL einem physischen Pfad zugeordnet hat. |
Globale Benachrichtigungskonstanten
Die folgenden Konstanten werden mit der IHttpModuleRegistrationInfo::SetGlobalNotifications-Methode verwendet, um anzugeben, welche Benachrichtigungen auf globaler Ebene von einem HTTP-Modul verarbeitet werden sollen.
| Dauerhaft | Bitmaske | BESCHREIBUNG |
|---|---|---|
| GL_STOP_LISTENING | 0x00000002 | Gibt an, dass IIS neue Anforderungen nicht mehr akzeptiert. |
| GL_CACHE_CLEANUP | 0x00000004 | Gibt an, dass IIS den Cache bereinigt hat. |
| GL_CACHE_OPERATION | 0x00000010 | Gibt an, dass ein Cachevorgang aufgetreten ist. |
| GL_HEALTH_CHECK | 0x00000020 | Gibt an, dass eine Integritätsprüfung stattgefunden hat. |
| GL_CONFIGURATION_CHANGE | 0x00000040 | Gibt an, dass sich die IIS-Konfiguration geändert hat. |
| GL_FILE_CHANGE | 0x00000080 | Gibt an, dass eine Datei geändert wurde. |
| GL_PRE_BEGIN_REQUEST | 0x00000100 | Gibt an, dass eine Anforderung in die integrierte Anforderungsverarbeitungspipeline aufgenommen wird. |
| GL_APPLICATION_START | 0x00000200 | Gibt an, dass eine Anwendung gestartet wurde. |
| GL_APPLICATION_RESOLVE_MODULES | 0x00000400 | Gibt an, dass IIS die Module für eine Anwendung aufgelöst hat. |
| GL_APPLICATION_STOP | 0x00000800 | Gibt an, dass eine Anwendung beendet wurde. |
| GL_RSCA_QUERY | 0x00001000 | Gibt an, dass eine Run-Time Status- und Steuerungsabfrage ausgegeben wurde. |
| GL_TRACE_EVENT | 0x00002000 | Gibt an, dass ein IIS-Ablaufverfolgungsereignis ausgelöst wurde. |
| GL_CUSTOM_NOTIFICATION | 0x00004000 | Gibt an, dass eine benutzerdefinierte Benachrichtigung auf globaler Ebene erfolgt ist. |
| GL_THREAD_CLEANUP | 0x00008000 | Gibt an, dass IIS einen Thread bereinigt hat. |
Prioritätsaaliaskonstanten
Die folgenden Konstanten werden mit den Methoden IHttpModuleRegistrationInfo::SetPriorityForRequestNotification und IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification verwendet, um die Prioritätsebene für Benachrichtigungen anzugeben.
Hinweis
Die Prioritätsstufen werden für RQ_SEND_RESPONSE Benachrichtigungen invertiert.
| Konstante | Wert | BESCHREIBUNG |
|---|---|---|
| PRIORITY_ALIAS_FIRST | L"FIRST" | Gibt an, dass das Modul vor allen anderen Modulen verarbeitet werden soll. Gibt RQ_SEND_RESPONSE für Benachrichtigungen an, dass das Modul nach allen anderen Modulen verarbeitet werden soll. |
| PRIORITY_ALIAS_HIGH | L"HIGH" | Gibt an, dass das Modul mit hoher Priorität verarbeitet werden soll. Gibt RQ_SEND_RESPONSE für Benachrichtigungen an, dass das Modul mit niedriger Priorität verarbeitet werden soll. |
| PRIORITY_ALIAS_MEDIUM | L"MEDIUM" | Gibt an, dass das Modul mit mittlerer Priorität verarbeitet werden soll. |
| PRIORITY_ALIAS_LOW | L"LOW" | Gibt an, dass das Modul mit niedriger Priorität verarbeitet werden soll. Gibt RQ_SEND_RESPONSE für Benachrichtigungen an, dass das Modul mit hoher Priorität verarbeitet werden soll. |
| PRIORITY_ALIAS_LAST | L"LAST" | Gibt an, dass das Modul nach allen anderen Modulen verarbeitet werden soll. Gibt RQ_SEND_RESPONSE für Benachrichtigungen an, dass das Modul vor allen anderen Modulen verarbeitet werden soll. |
Context-Cloning Konstanten
Die folgenden Konstanten werden mit der IHttpContext::CloneContext-Methode verwendet, um anzugeben, welche Abschnitte des Kontexts geklont werden sollen.
| Konstante | Wert | BESCHREIBUNG |
|---|---|---|
| CLONE_FLAG_BASICS | 0x01 | Gibt an, dass die URL, die Abfragezeichenfolge und die HTTP-Methode geklont werden sollen. |
| CLONE_FLAG_HEADERS | 0x02 | Gibt an, dass die Anforderungsheader geklont werden sollen. |
| CLONE_FLAG_ENTITY | 0x04 | Gibt an, dass der Entitätstext geklont werden soll. |
| CLONE_FLAG_NO_PRECONDITION | 0x08 | Gibt an, dass alle "range"- und "if-"-Header für die Anforderung nicht in den Klonvorgang einbezogen werden sollen. |
| CLONE_FLAG_NO_DAV | 0x10 | Gibt an, dass webDAV-Header für die Anforderung nicht in den Klonvorgang einbezogen werden sollen. |
Request-Execution Konstanten
Die folgenden Konstanten werden mit der IHttpContext::ExecuteRequest-Methode verwendet, um das Ausführungsverhalten für einen untergeordneten Kontext anzugeben.
| Konstante | Wert | BESCHREIBUNG |
|---|---|---|
| EXECUTE_FLAG_NO_HEADERS | 0x01 | Gibt an, dass die HTTP-Header für die untergeordnete Anforderung unterdrückt werden sollen. |
| EXECUTE_FLAG_IGNORE_CURRENT_INTERCEPTOR | 0x02 | Gibt an, dass der aktuelle Skriptzuordnungshandler für diese Anforderungskette ignoriert werden soll. |
| EXECUTE_FLAG_IGNORE_APPPOOL | 0x04 | Gibt an, dass die Anforderung ausgeführt werden soll, auch wenn sich die untergeordnete Anforderung nicht im selben Anwendungspool befindet. |
| EXECUTE_FLAG_DISABLE_CUSTOM_ERROR | 0x08 | Gibt an, dass die benutzerdefinierten Fehler für die untergeordnete Anforderung deaktiviert werden sollen. |
| EXECUTE_FLAG_SAME_URL | 0x10 | Gibt an, dass die URL für die untergeordnete Anforderung mit der URL für die übergeordnete Anforderung identisch ist. |
| EXECUTE_FLAG_BUFFER_RESPONSE | 0x20 | Gibt an, dass die untergeordnete Antwort an die übergeordnete Anforderung zurückgegeben und nicht geleert werden soll. |
| EXECUTE_FLAG_HTTP_CACHE_ELIGIBLE | 0x40 | Gibt an, dass die untergeordnete Antwort weiterhin zum Zwischenspeichern durch Http.sys berechtigt ist. |
Weitere Informationen
Webserverkernkonstanten
Web Server Core-API-Referenz
IHttpContext::CloneContext-Methode
IHttpContext::ExecuteRequest-Methode
IHttpModuleRegistrationInfo::SetGlobalNotifications-Methode
IHttpModuleRegistrationInfo::SetPriorityForRequestNotification-Methode
IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification-Methode
IHttpModuleRegistrationInfo::SetRequestNotifications-Methode