Freigeben über


IHttpStoredContext-Schnittstelle

Definiert Kontextinformationen für gespeicherte Daten.

Syntax

class IHttpStoredContext  

Methoden

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

Name Beschreibung
CleanupStoredContext Bereinigt den gespeicherten Kontext.

Abgeleitete Klassen

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

Hinweise

Viele IIS 7-Klassen verwalten einen private IDispensedHttpModuleContextContainer-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. Auf diese Weise 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 zu einem IHttpModuleContextContainer Zeiger hinzufügen und abrufen, indem Sie die Methoden "IHttpModuleContextContainer::SetModuleContext " bzw . "IHttpModuleContextContainer::GetModuleContext " aufrufen.

Wenn der IHttpStoredContext Zeiger nicht mehr benötigt wird, wird die CleanupStoredContext Methode intern aufgerufen, wobei der Implementierer der Schnittstellenmethode in der IHttpStoredContext Regel aufgerufen delete``thiswerden soll.

Achtung

Obwohl es sich um einen sicheren Vorgang handelt, um einen IHttpModuleContextContainer IDispensedHttpModuleContextContainer Vorgang mithilfe des dynamic_cast-Operators zu downcasten, sollten Sie diese Umwandlung vermeiden. Die IDispensedHttpModuleContextContainer Schnittstelle fügt nur eine Methode, ReleaseContainer, zur Basisschnittstelle hinzu, 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 unter Windows 10
Server IIS 7.0 unter Windows Server 2008
- IIS 7.5 unter Windows Server 2008 R2
IIS 8.0 auf 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