IHttpSite::GetModuleContextContainer メソッド

サイトのコンテキスト コンテナーを返します。

構文

virtual IHttpModuleContextContainer* GetModuleContextContainer(  
   VOID  
) = 0;  

パラメーター

このメソッドは、パラメーターを受け取りません。

戻り値

IHttpModuleContextContainer へのポインター。

解説

メソッドの戻り値は GetModuleContextContainer 実装によって異なります。 既定では、現在の実装では、同期 されるが分配されない IDispensedHttpModuleContextContainer インターフェイスが作成されます。

実装側の注意

IHttpSite 実装者は、このデータを使用したメモリ管理を担当します。したがって、実装者は、IHttpSite構築時にポインターをIDispensedHttpModuleContextContainer作成し、ポインターの有効期間のためにこのIDispensedHttpModuleContextContainerポインターへの参照を保持privateするIHttpSite必要があります。 メソッドを呼び出すときは GetModuleContextContainer 、アップキャストして、この同じ IDispensedHttpModuleContextContainer ポインターを返す必要があります。 インターフェイスを実装IHttpSiteする クラスのデストラクターを呼び出すとき、このデストラクターは、このprivate参照で IDispensedHttpModuleContextContainer::ReleaseContainer メソッドを呼び出し、その参照を NULL に設定する必要があります。

GetModuleContextContainer は NULL を返すべきではありません。 内部コンテナーが NULL の場合は、この内部コンテナーを IHttpServer::D ispenseContainer の呼び出しの値に設定し、この同じコンテナーを返します。

呼び出し元に関する注意事項

IHttpSite実装者は、このデータを使用したメモリ管理を担当します。そのため、クライアントは、IHttpSiteこのデータが不要になったときに、返されたIHttpModuleContextContainerポインターを解放、呼び出deleteし、またはダウンキャストして呼び出IDispensedHttpModuleContextContainer::ReleaseContainerしを試みてはいけません。

例

次のコード例は、 インターフェイスを実装する という名前 MyContainer の IDispensedHttpModuleContextContainer カスタム クラスと、 インターフェイスを実装する という名前 MyClass のカスタム クラスを IHttpSite 示しています。 MyClass は、ポインターの MyContainer 有効期間中にポインターを MyClass 管理します。

// The MyContainer class implements the   
// IDispensedHttpModuleContextContainer interface.  
class MyContainer : public IDispensedHttpModuleContextContainer  
{  
public:  
    // The MyContainer method is the public  
    // constructor for the MyContainer class.  
    // Make this method protected if the   
    // MyContainer class is abstract.  
    // dispensed: true if the container should  
    // call delete this when the ReleaseContainer  
    // method is called.  
    MyContainer(bool dispensed = false)   
        : m_dispensed(dispensed)  
    {  
  
    }  
  
    // The ReleaseContainer method   
    // calls delete this if this container  
    // is dispensed.  
    virtual VOID ReleaseContainer(VOID)  
    {  
        if (m_dispensed)  
        {  
            delete this;  
        }  
    }  
  
    // Implement additional   
    // IDispensedHttpModuleContextContainer  
    // pure virtual methods if this class  
    // is not abstract.  
  
private:  
    // The MyContainer method is the private  
    // destructor for the MyContainer class.  
    // Make this method protected and virtual   
    // if the MyContainer class expects   
    // to be a class of derivation. This method   
    // should not be public because   
    // IDispensedHttpModuleContextContainer pointers  
    // should be disposed externally only by   
    // calling the ReleaseContainer method.  
    ~MyContainer()  
    {  
  
    }  
  
    // Specify a Boolean value for dispensing.  
    bool m_dispensed;  
};  
  
// The MyClass class implements the  
// IHttpSite interface.  
class MyClass : public IHttpSite  
{  
public:  
    // The MyClass method is the public  
    // constructor for the MyClass class.  
    MyClass()  
    {  
        m_container = new MyContainer;  
    }  
  
    // The MyClass method is the   
    // public virtual destructor   
    // for the MyClass class. This destructor  
    // calls ReleaseContainer on the internal  
    // IDispensedHttpModuleContextContainer  
    // pointer and sets that pointer to NULL.  
    virtual ~MyClass()  
    {  
        m_container->ReleaseContainer();  
        m_container = NULL;  
    }  
  
    // The GetModuleContextContainer method  
    // returns an IHttpModuleContextContainer  
    // pointer.  
    // return: an explicit upcast   
    // IDispensedHttpModuleContextContainer  
    // pointer for readability.  
    virtual IHttpModuleContextContainer*   
        GetModuleContextContainer(VOID)  
    {  
        return (IHttpModuleContextContainer*)m_container;  
    }  
  
    // Implement additional IHttpSite  
    // pure virtual methods if this class  
    // is not abstract.  
  
private:  
    // Specify a private  
    // IDispensedHttpModuleContextContainer  
    // pointer.  
    IDispensedHttpModuleContextContainer* m_container;  
};  

要件

参照

IHttpSite インターフェイス
IHttpApplication::GetModuleContextContainer メソッド
IHttpConnection::GetModuleContextContainer メソッド
IHttpContext::GetModuleContextContainer メソッド
IHttpFileInfo::GetModuleContextContainer メソッド
IHttpFileMonitor::GetModuleContextContainer メソッド
IHttpUrlInfo::GetModuleContextContainer メソッド
IMetadataInfo::GetModuleContextContainer メソッド