IHttpStoredContext-Schnittstelle

Definiert Kontextinformationen für gespeicherte Daten.

Syntax

class IHttpStoredContext  

Methoden

In der folgenden Tabelle sind die Methoden aufgeführt, die von der IHttpStoredContext -Klasse verfügbar gemacht werden.

Name	BESCHREIBUNG
CleanupStoredContext	Bereinigt den gespeicherten Kontext.

Abgeleitete Klassen

Name	BESCHREIBUNG
IWebSocketContext	Stellt Kontextunterstützung für bidirektionale WebSocket-Kommunikation über einen einzelnen TCP-Socket dar.

Bemerkungen

Viele IIS 7-Klassen verwalten einen privateIDispensedHttpModuleContextContainer-Zeiger als Membervariable. Diese Klassen implementieren verschiedene Schnittstellen, einschließlich IHttpApplication, IHttpConnection, IHttpContext, IHttpFileInfo, IHttpSite, IHttpUrlInfo und IMetadataInfo.

Jede dieser Schnittstellen definiert eine GetModuleContextContainer Methode, die keine Argumente akzeptiert und einen IHttpModuleContextContainer-Zeiger zurückgibt. Wenn die verschiedenen GetModuleContextContainer Methoden aufgerufen werden, geben die meisten dieser Implementierer die private Daten als Upcast IHttpModuleContextContainerzurück. Dadurch können die Schnittstellenimplementierer benutzerdefinierte Container verfügbar machen und gleichzeitig die Lebensdauer dieser Container beibehalten.

Sie können benutzerdefinierte Klassen definieren, die die IHttpStoredContext Schnittstelle implementieren, und dann einen Zeiger auf diese IHttpStoredContext Klassenimplementierer erstellen, indem Sie den new Operator aufrufen. Anschließend können Sie diesen Zeiger auf einem IHttpModuleContextContainer Zeiger hinzufügen und abrufen, indem Sie die Methoden IHttpModuleContextContainer::SetModuleContext und IHttpModuleContextContainer::GetModuleContext aufrufen.

Wenn der IHttpStoredContext Zeiger nicht mehr benötigt wird, wird die CleanupStoredContext -Methode intern aufgerufen, wobei der Implementierer der IHttpStoredContext Schnittstellenmethode normalerweise aufrufen delete``thissollte.

Achtung

Es kann zwar ein sicherer Vorgang sein, ein IHttpModuleContextContainer mithilfe des dynamic_cast-Operators herunterzuwerfenIDispensedHttpModuleContextContainer, sie sollten diese Umwandlung jedoch vermeiden. Die IDispensedHttpModuleContextContainer -Schnittstelle fügt ihrer Basisschnittstelle nur eine Methode hinzu, ReleaseContainer, und diese Methode sollte nur intern aufgerufen werden.

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 auf 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 auf 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