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

Weitere Informationen

Webserverkernschnittstellen