ICacheProvider：：SetCacheRecord 方法
設定快取提供者上的快取特定資料。
語法
virtual VOID SetCacheRecord(
IHttpCacheSpecificData* pCacheRecord
) = 0;
參數
pCacheRecord
IHttpCacheSpecificData值的指標。
備註
參數 pCacheRecord 不得為 Null，因為稍後對 GetCacheRecord 方法的內部呼叫可能會導致存取違規。
重要
方法 SetCacheRecord 是 IIS 基礎結構的一部分，不適合直接從您的程式碼使用。
實作者的注意事項
ICacheProvider 實作器會將 private``IHttpCacheSpecificData 指標宣告為成員資料。 呼叫這些實作者的建構函式時，會將這個成員資料指派給 IHttpCacheSpecificData 指標。 呼叫 SetCacheRecord 之前，呼叫端負責先在指標上 IHttpCacheSpecificData 呼叫IHttpCacheSpecificData：：ReferenceCacheData; SetCacheRecord 實作者接著將 private 變數指派給這個 IHttpCacheSpecificData 指標。
呼叫 時 SetCacheRecord ，實作者應該先檢查目前的 private 成員指標是否為非 Null。 private如果資料不是 Null，請先在此目前資料上呼叫IHttpCacheSpecificData：:D ereferenceCacheData，以便釋放它，但一律將 private 變數指派給 pCacheRecord 參數。
下表是一對一介面對應的範例，必須從 GetCacheKey 和 GetCacheRecord 介面的相同實作器 ICacheProvider 傳回方法。
| GetCacheKey 介面 | GetCacheRecord 介面 |
|---|---|
| IFileKey | IHttpFileInfo |
| IHttpTokenKey | IHttpTokenEntry |
| IHttpCacheKey | IHttpCacheSpecificData |
來電者的附注
ICacheProvider 實作者會取得指標的 IHttpCacheSpecificData 擁有權。 在呼叫 SetCacheRecord 之前，請先在指標上呼叫 IHttpCacheSpecificData::ReferenceCacheData ，讓此指標擁有一個擁有者。
規格需求
| 類型 | 描述 |
|---|---|
| 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 |