IDispensedHttpModuleContextContainer Interface
Extends the IHttpModuleContextContainer interface by providing functionality for releasing a container.
Syntax
class IDispensedHttpModuleContextContainer : public IHttpModuleContextContainer
Methods
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.) |
Derived Classes
This class contains no derived classes.
Remarks
Many IIS 7 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.
Warning
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.
Inheritance Hierarchy
IDispensedHttpModuleContextContainer
Requirements
| Type | Description |
|---|---|
| Client | - IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10 |
| Server | - IIS 7.0 on Windows Server 2008 - 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 Technical Preview |
| Product | - 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 |