ICacheProvider::SetCacheRecord メソッド
キャッシュ プロバイダー上のキャッシュ固有のデータを設定します。
構文
virtual VOID SetCacheRecord(
IHttpCacheSpecificData* pCacheRecord
) = 0;
パラメーター
pCacheRecord
IHttpCacheSpecificData 値へのポインター。
解説
GetCacheRecord メソッドをpCacheRecord
後で内部呼び出すとアクセス違反が発生する可能性があるため、パラメーターを NULL にすることはできません。
重要
メソッドは SetCacheRecord
IIS インフラストラクチャの一部であり、コードから直接使用することを意図したものではありません。
実装側の注意
ICacheProvider 実装者 は、ポインターを private``IHttpCacheSpecificData
メンバー データとして宣言します。 これらの実装者のコンストラクターが呼び出されると、このメンバー データがポインターに IHttpCacheSpecificData
割り当てられます。 を呼び出すSetCacheRecord
前に、呼び出し元は最初にポインターで IHttpCacheSpecificData
IHttpCacheSpecificData::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 |