| title | IReadEntityProvider Interface |
|---|---|
| description | Learn how the IReadEntityProvider interface provides an interface for retrieving or modifying the request entity. |
| ms.date | 10/07/2016 |
| ms.assetid | 88a39d22-b9ac-9ee7-1127-57158a8a9c4c |
Provides an interface for retrieving or modifying the request entity.
class IReadEntityProvider : public IHttpEventProvider The following table lists the methods exposed by the IReadEntityProvider interface.
| Name | Description |
|---|---|
| GetEntity | Retrieves the request entity. |
| SetEntity | Specifies the request entity. |
| SetErrorStatus | (Inherited from IHttpEventProvider.) |
This interface contains no derived classes.
IIS creates and passes an IReadEntityProvider interface to a module's CHttpModule::OnReadEntity method when the module has registered for the RQ_READ_ENTITY notification in the module's exported RegisterModule function.
Note IIS will trigger CHttpModule::OnReadEntity() event for every IHttpRequest::ReadEntityBody Method even if there is no entity left to read. This behavior addresses scenarios where a module should insert some entity when there is no request entity. You must write some entity-length-verification code so that your CHttpModule::OnReadEntity() handler is aware of the possibility of a zero entity length.
IReadEntityProvider
| 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 |