IHttpCacheSpecificData：：ReferenceCacheData 方法

發行項
07/19/2023

遞增快取資料的內部參考計數。

語法

virtual VOID ReferenceCacheData(  
   VOID  
) = 0;

參數

此方法不會採用任何參數。

執行緒安全性

實作 IHttpCacheSpecificData 介面的類別是 DereferenceCacheData 和 ReferenceCacheData 方法的安全線程。

備註

實作介面的 IHttpCacheSpecificData 類別會使用執行緒安全記憶體管理的參考計數。 IHttpCacheSpecificData建構指標時， (private 成員變數) 的內部參考計數會設定為 1。 ReferenceCacheData呼叫方法時，這個參考計數會遞增 1。 DereferenceCacheData呼叫方法時，這個相同的參考計數會遞減 1。只有在參考計數移至 0 時， IHttpCacheSpecificData 才會從堆積中移除指標。此配置可確保 IHttpCacheSpecificData 在指標的最後一個用戶端呼叫 DereferenceCacheData 之前，不會刪除指標。

實作者的注意事項

ReferenceCacheData和 DereferenceCacheData 方法實作應該是介面的安全 IHttpCacheSpecificData 執行緒。實作者應該提供 protected 或 private 解構函式，只有在參考計數進入 0 時，才會在內部呼叫。

來電者的注意事項

用戶端絕不應該嘗試將指標轉換成 IHttpCacheSpecificData 更特定的類別，然後直接呼叫 delete 。用戶端應該改為在擷取介面指標 IHttpCacheSpecificData 時，只呼叫 ReferenceCacheData 方法一次，然後在不再存取指標時 IHttpCacheSpecificData 呼叫 DereferenceCacheData 方法。您應該 ReferenceCacheData 分別 IHttpCacheSpecificData 呼叫和 DereferenceCacheData 方法，以確保在不再需要時存取和刪除指標時，在堆積上有效。

範例

下列程式碼範例示範名為 MySpecificData 的類別，該類別會 IHttpCacheSpecificData 實作方法。

// Create a class that implements the IHttpCacheSpecificData interface.  
class MySpecificData : public IHttpCacheSpecificData  
{  
public:  
    // Create a public constructor.  
    // Set the internal reference count to 1.  
    MySpecificData ()  
    {  
        m_cRefs = 1;  
    }  
  
    // Increment the internal reference count.  
    virtual VOID ReferenceCacheData(VOID)  
    {  
        InterlockedIncrement(&m_cRefs);  
    }  
  
    // Decrement the internal reference count.  
    virtual VOID DereferenceCacheData(VOID)  
    {  
        // Decrement the reference count and delete this  
        // if the count is 0.  
        if (0 == InterlockedDecrement(&m_cRefs))  
        {  
            delete this;  
        }  
    }  
  
    // To do: implement custom MySpecificData implementation.  
  
private:  
    // Create a private destructor called from DereferenceCacheData.  
    virtual ~MySpecificData ()  
    {  
  
    }  
  
    // Create a private reference count member.  
    LONG m_cRefs;  
}

規格需求

類型	描述
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

另請參閱

IHttpCacheSpecificData 介面

共用方式為