Freigeben über

Request-Processing Konstanten

  • Artikel

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