| title | description | ms.date | ms.assetid |
|---|---|---|---|
IDispensedHttpModuleContextContainer Interface |
Describes the IDispensedHttpModuleContextContainer interface and details its syntax, methods, derived classes, remarks, inheritance hierarchy, and requirements. |
10/07/2016 |
8a58dbe1-8832-9da9-5733-2a9ff2f22962 |
Extends the IHttpModuleContextContainer interface by providing functionality for releasing a container.
class IDispensedHttpModuleContextContainer : public IHttpModuleContextContainer The following table lists the methods exposed by the IDispensedHttpModuleContextContainer class.
| Name | Description |
|---|---|
| GetModuleContext | (Inherited from IHttpModuleContextContainer.) |
| ReleaseContainer | Deletes the context container if it is dispensed. |
| SetModuleContext | (Inherited from IHttpModuleContextContainer.) |
This class contains no derived classes.
Many [!INCLUDEiisver] classes maintain a private IDispensedHttpModuleContextContainer pointer as a member variable. These classes implement various interfaces, including IHttpApplication, IHttpConnection, IHttpContext, IHttpFileInfo, IHttpSite, IHttpUrlInfo, and IMetadataInfo.
Each of these interfaces defines a GetModuleContextContainer method, which accepts no arguments and returns an IHttpModuleContextContainer pointer. When the various GetModuleContextContainer methods are called, most of these implementers return the private data as an upcast IHttpModuleContextContainer. This allows the interface implementers to expose custom containers while maintaining the lifetime of those containers.
Caution
While it may be a safe operation to downcast an IHttpModuleContextContainer to an IDispensedHttpModuleContextContainer by using the dynamic_cast operator, you should avoid performing this cast. The IDispensedHttpModuleContextContainer interface adds only one method, ReleaseContainer, to its base interface, and this method should be called only internally.
IDispensedHttpModuleContextContainer
| Type | Description |
|---|---|
| Client | - IIS 7.0 on [!INCLUDEwinvista] - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10 |
| Server | - IIS 7.0 on [!INCLUDEwinsrv2008] - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016 |
| Product | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - [!INCLUDEiisexp75], [!INCLUDEiisexp80], [!INCLUDEiisexp100] |
| Header | Httpserv.h |