IReadEntityProvider インターフェイス
要求エンティティを取得または変更するためのインターフェイスを提供します。
構文
class IReadEntityProvider : public IHttpEventProvider
メソッド
次の表に、 インターフェイスによって公開されるメソッドの一覧を IReadEntityProvider 示します。
| 名前 | 説明 |
|---|---|
| GetEntity | 要求エンティティを取得します。 |
| SetEntity | 要求エンティティを指定します。 |
| SetErrorStatus | ( IHttpEventProvider から継承されます)。 |
派生クラス
このインターフェイスには、派生クラスが含まれています。
解説
モジュールがモジュールのIReadEntityProviderエクスポートされた RegisterModule 関数のRQ_READ_ENTITY通知に登録されている場合、IIS はモジュールの CHttpModule::OnReadEntity メソッドにインターフェイスを作成して渡します。
メモ読み取るエンティティが残っていない場合でも、IIS は IHttpRequest::ReadEntityBody メソッドごとにイベントをトリガーCHttpModule::OnReadEntity()します。 この動作は、要求エンティティがない場合にモジュールでエンティティを挿入する必要があるシナリオに対応します。 ハンドラーがエンティティの長さが 0 になる可能性を CHttpModule::OnReadEntity() 認識できるように、エンティティ長検証コードを記述する必要があります。
継承階層
IReadEntityProvider
要件
| Type | 説明 |
|---|---|
| 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 |
| Header | Httpserv.h |