IHttpServer-Schnittstelle
Stellt den Verarbeitungskontext für Vorgänge auf globaler Ebene dar.
Syntax
class IHttpServer
Methoden
In der folgenden Tabelle sind die Methoden aufgeführt, die von der IHttpServer -Schnittstelle verfügbar gemacht werden.
| Name | BESCHREIBUNG |
|---|---|
| AddFragmentToCache | Fügt dem Cache eine HTTP_DATA_CHUNK-Struktur hinzu. |
| AssociateWithThreadPool | Ordnet dem Threadpool einen asynchronen Vervollständigungsvorgang zu. |
| DecrementThreadCount | Verringert die Threadanzahl für den Threadpool. |
| DispenseContainer | Gibt einen Kontextcontainer zurück, der ausgegeben werden kann. |
| DoCacheOperation | Führt einen bestimmten Cachevorgang aus. |
| FlushKernelCache | Leert den Kernelcache für einen bestimmten URI (Uniform Resource Identifier). |
| GetAppPoolName | Ruft den Namen des Anwendungspools für die aktuelle Anforderung ab. |
| GetConfigObject | Ruft das Konfigurationsobjekt für den aktuellen Kontext ab. |
| Getfileinfo | Gibt eine IHttpFileInfo-Schnittstelle für einen bestimmten Dateipfad zurück. |
| GetManagedType | Ruft den verwalteten Typ für einen bestimmten Standort und den URI (Uniform Resource Identifier) ab. |
| GetPerfCounterInfo | Ruft eine IHttpPerfCounterInfo-Schnittstelle ab. |
| GetProtocolManagerCustomInterface | Ruft eine benutzerdefinierte Schnittstelle für einen Protokoll-Manager ab. |
| GetTraceContext | Ruft eine IHttpTraceContext-Schnittstelle ab. |
| GetWorkerProcessSettings | Ruft eine IWpfSettings-Schnittstelle ab. |
| IncrementThreadCount | Erhöht die Threadanzahl für den Threadpool. |
| IsCommandLineLaunch | Testet, ob der Arbeitsprozess über die Befehlszeile gestartet wurde. |
| NotifyConfigurationChange | Löst eine Benachrichtigung aus, dass sich ein Konfigurationspfad geändert hat. |
| NotifyCustomNotification | Löst eine benutzerdefinierte Benachrichtigung auf globaler Ebene aus. |
| NotifyFileChange | Löst eine Benachrichtigung aus, dass eine Datei geändert wurde. |
| ReadFragmentFromCache | Ruft ein bestimmtes Fragment aus dem Cache ab. |
| RecycleApplication | Verwendet eine Anwendung wieder. |
| RecycleProcess | Verwendet den Arbeitsprozess, der die aktuelle Anforderung verarbeitet. |
| RegisterFileChangeMonitor | Registriert die Dateiänderungsbenachrichtigung für ein bestimmtes Verzeichnis. |
| RemoveFragmentFromCache | Entfernt ein bestimmtes Fragment aus dem Cache. |
| ReportUnhealthy | Meldet den Arbeitsprozess als fehlerhaft. |
| ErfülltPrecondition | Bestimmt, ob eine bestimmte Voraussetzung für die aktuelle Anforderung erfüllt wurde. |
Abgeleitete Klassen
| Name | BESCHREIBUNG |
|---|---|
| IHttpServer2 | Stellt den Verarbeitungskontext für Vorgänge auf globaler Ebene dar und ermöglicht das Abrufen von Konfigurationsdateien, erweiterten Schnittstellen, Metadaten, Token und dem Workerprozessframework. |
Bemerkungen
Die IHttpServer Schnittstelle stellt die Standard programmgesteuerte Schnittstelle für HTTP-Module dar, um auf Informationen über den aktuellen Kontext auf globaler Ebene zuzugreifen. Diese Schnittstelle ruft mehrere zusätzliche Schnittstellen ab, die Sie beim Schreiben von HTTP-Modulen verwenden können. Die Methoden und GetPerfCounterInfo rufen beispielsweise GetFileInfo die IHttpFileInfo Schnittstellen und IHttpPerfCounterInfo für den globalen Kontext ab. Mit diesen Schnittstellen können Entwickler eine Dateischnittstelle für eine bestimmte Datei oder eine Schnittstelle für die Leistungsindikatoren abrufen.
IIS 7 ermöglicht Es Entwicklern, eine Anwendung neu zu starten, einen Arbeitsprozess neu zu starten oder den aktuellen Kontext als fehlerhaft zu melden. Diese Funktionalität wird über die RecycleApplicationMethoden , RecycleProcessund ReportUnhealthy verfügbar gemacht.
Die IHttpServer Schnittstelle bietet mehrere Methoden, mit denen Entwickler den IIS-Cache bearbeiten können. Bei diesen Methoden handelt es sich um die AddFragmentToCacheMethoden , DoCacheOperationFlushKernelCache, ReadFragmentFromCache, und RemoveFragmentFromCache .
Hinweis
Http.sys verwaltet und besitzt den Fragmentcache. Http.sys können jederzeit Informationen überschreiben oder löschen, die Sie zur Speicherung weitergeleitet haben. Es gibt derzeit keine Möglichkeit, Informationen im Fragmentcache als nicht flüchtige Informationen zu sperren.
Entwickler können die GetAppPoolNameMethoden , GetManagedType, GetWorkerProcessSettingsund SatisfiesPrecondition verwenden, um Informationen aus den Konfigurationseinstellungen für den aktuellen Kontext abzurufen.
Die IHttpServer Schnittstelle stellt auch die NotifyConfigurationChangeMethoden , NotifyFileChange, NotifyCustomNotification bereit, mit denen Entwickler Benachrichtigungen für Konfigurationsänderungen, Dateiänderungen oder eine benutzerdefinierte Benachrichtigungsbedingung auslösen können.
Anforderungen
| type | BESCHREIBUNG |
|---|---|
| Client | – IIS 7.0 unter Windows Vista – IIS 7.5 unter Windows 7 – IIS 8.0 unter Windows 8 – IIS 10.0 unter Windows 10 |
| Server | – IIS 7.0 unter Windows Server 2008 – IIS 7.5 unter Windows Server 2008 R2 – IIS 8.0 unter Windows Server 2012 – IIS 8.5 unter Windows Server 2012 R2 – IIS 10.0 unter Windows Server 2016 |
| Produkt | – IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0 |
| Header | Httpserv.h |