提供用來擷取或修改要求實體的介面。
Syntax
class IReadEntityProvider : public IHttpEventProvider
方法
下表列出 介面所 IReadEntityProvider 公開的方法。
| 名稱 | 描述 |
|---|---|
| GetEntity | 擷取要求實體。 |
| SetEntity | 指定要求實體。 |
| SetErrorStatus | (繼承自 IHttpEventProvider.) |
衍生類別
這個介面不包含衍生類別。
備註
IIS 會在模組匯出的 RegisterModule函式中註冊RQ_READ_ENTITY通知時,建立介面並傳遞 IReadEntityProvider 至模組的CHttpModule::OnReadEntity方法。
注意 即使沒有要讀取的實體,IIS 也會觸發 CHttpModule::OnReadEntity() 每個 IHttpRequest::ReadEntityBody 方法 的事件。 此行為可解決當沒有要求實體時,模組應該插入某些實體的案例。 您必須撰寫一些實體長度驗證碼, CHttpModule::OnReadEntity() 讓處理常式知道零實體長度的可能性。
繼承階層架構
IReadEntityProvider
規格需求
| 類型 | 描述 |
|---|---|
| Client | - 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 |
| 標頭 | Httpserv.h |