IReadEntityProvider 接口
提供用于检索或修改请求实体的接口。
语法
class IReadEntityProvider : public IHttpEventProvider
方法
下表列出了 接口公开 IReadEntityProvider 的方法。
| 名称 | 说明 |
|---|---|
| GetEntity | 检索请求实体。 |
| SetEntity | 指定请求实体。 |
| SetErrorStatus | (继承自 IHttpEventProvider.) |
派生类
此接口不包含派生类。
备注
当模块在模块的导出 RegisterModule 函数中注册RQ_READ_ENTITY通知时，IIS 会创建一个IReadEntityProvider接口并将其传递给模块的 CHttpModule：：OnReadEntity 方法。
注意即使没有要读取的实体，IIS 也会为每个 IHttpRequest：：ReadEntityBody 方法触发CHttpModule::OnReadEntity()事件。 此行为解决了在没有请求实体时模块应插入一些实体的情况。 必须编写一些实体长度验证码，以便 CHttpModule::OnReadEntity() 处理程序知道实体长度为零的可能性。
继承层次结构
IReadEntityProvider
要求
| 类型 | 说明 |
|---|---|
| 客户端 | - Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10 上的 IIS 10.0 |
| 服务器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016 上的 IIS 10.0 |
| 产品 | - 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 |