IHttpUser：：ReferenceUser 方法

發行項
07/19/2023

遞增使用者內部參考計數。

語法

virtual VOID ReferenceUser(  
   VOID  
) = 0;

參數

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

執行緒安全性

實作IHttpUser介面的類別是和DereferenceUser方法的 ReferenceUser 執行緒安全。

備註

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

實作者的注意事項

ReferenceUser和 DereferenceUser 方法實作應該是指標的安全 IHttpUser 執行緒。實作者應該只 privateprotected 提供或解構函式，這些函式只有在參考計數進入 0 時才會呼叫。

來電者的注意事項

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

範例

下列程式碼範例示範名為 MyHttpUser 的類別，該類別會實作 IHttpUser 介面。

// Create a class that implements the IHttpUser interface.  
class MyHttpUser : public IHttpUser  
{  
public:  
    // Create a public constructor.  
    // Set the internal reference count to 1.  
    MyHttpUser()  
    {  
        m_cRefs = 1;  
    }  
  
    // Increment the internal reference count.  
    virtual VOID ReferenceUser(VOID)  
    {  
        InterlockedIncrement(&m_cRefs);  
    }  
  
    // Decrement the internal reference count.  
    virtual VOID DereferenceUser(VOID)  
    {  
        // Decrement the reference count and call delete this  
        // if the count is 0.  
        if (0 == InterlockedDecrement(&m_cRefs))  
        {  
            delete this;  
        }  
    }  
  
private:  
    // Create a private destructor called from DereferenceUser.  
    virtual ~MyHttpUser()  
    {  
  
    }  
  
    // 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

另請參閱

IHttpUser 介面

共用方式為