キャッシュ プロバイダー上のキャッシュ固有のデータを設定します。
構文
virtual VOID SetCacheRecord(
IHttpCacheSpecificData* pCacheRecord
) = 0;
パラメーター
pCacheRecord
IHttpCacheSpecificData 値へのポインター。
解説
GetCacheRecord メソッドをpCacheRecord後で内部呼び出すとアクセス違反が発生する可能性があるため、パラメーターを NULL にすることはできません。
重要
メソッドは SetCacheRecord IIS インフラストラクチャの一部であり、コードから直接使用することを意図したものではありません。
実装側の注意
ICacheProvider 実装者 は、ポインターを private``IHttpCacheSpecificData メンバー データとして宣言します。 これらの実装者のコンストラクターが呼び出されると、このメンバー データがポインターに IHttpCacheSpecificData 割り当てられます。 を呼び出すSetCacheRecord前に、呼び出し元は最初にポインターで IHttpCacheSpecificDataIHttpCacheSpecificData::ReferenceCacheData を呼び出し、SetCacheRecord実装者はこのIHttpCacheSpecificDataポインターに変数をprivate割り当てます。
が呼び出されるとSetCacheRecord、現在privateのメンバー ポインターが NULL 以外の場合、実装者は最初にチェックする必要があります。 データが NULL 以外の private 場合は、この現在のデータに対 して IHttpCacheSpecificData::D ereferenceCacheData を最初に呼び出して解放できるようにしますが、その後は常に変数を private パラメーターに pCacheRecord 割り当てます。
次の表は、 GetCacheKey から返される必要がある 1 対 1 のインターフェイス マッピングのサンプルと、 GetCacheRecord インターフェイスの同じ実装者からメソッドを ICacheProvider 示しています。
| GetCacheKey インターフェイス | GetCacheRecord インターフェイス |
|---|---|
| IFileKey | IHttpFileInfo |
| IHttpTokenKey | IHttpTokenEntry |
| IHttpCacheKey | IHttpCacheSpecificData |
呼び出し元に関する注意事項
ICacheProvider 実装者はポインターの所有権を IHttpCacheSpecificData 取得します。 を呼び出す SetCacheRecord前に、最初に ポインターを呼び出して IHttpCacheSpecificData::ReferenceCacheData 、このポインターに所有者が 1 人になるようにします。
要件
| 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 |