Metodo IHttpContext::GetModuleContextContainer

Recupera il contenitore di contesto del modulo per il contesto corrente.

Sintassi

virtual IHttpModuleContextContainer* GetModuleContextContainer(  
   VOID  
) = 0;  

Parametri

Questo metodo non accetta parametri.

Valore restituito

Puntatore a un'interfaccia IHttpModuleContextContainer .

Commenti

Il GetModuleContextContainer valore restituito dal metodo dipende dall'implementazione. Per impostazione predefinita, l'implementazione corrente crea un'interfaccia IDispensedHttpModuleContextContainer sincronizzata ma non distribuita.

Note per gli implementatori

Gli implementatori IHttpContext sono responsabili della gestione della memoria con questi dati; pertanto, IHttpContext gli implementatori devono creare un IDispensedHttpModuleContextContainer puntatore in fase di costruzione e tenere un private riferimento a questo IDispensedHttpModuleContextContainer puntatore per la vita del IHttpContext puntatore. Quando si chiama il metodo, è necessario eseguire il GetModuleContextContainer upcast e restituire lo stesso IDispensedHttpModuleContextContainer puntatore. Quando si chiama il distruttore della classe che implementa l'interfaccia IHttpContext , questo distruttore deve chiamare il metodo IDispensedHttpModuleContextContainer::ReleaseContainer in questo private riferimento e quindi impostare tale riferimento su NULL.

GetModuleContextContainer non deve restituire NULL. Se il contenitore interno è NULL, impostare questo contenitore interno sul valore della chiamata a IHttpServer::D ispenseContainer e quindi restituire lo stesso contenitore.

Nota

Anche se le operazioni di upcast implicite sono considerate sicure, prendere in considerazione l'uso di un cast esplicito per la chiarezza del programma. Prendere in considerazione anche l'uso dell'operatore dynamic_cast ogni volta che è possibile.

Note per i chiamanti

IHttpContext gli implementatori sono responsabili della gestione della memoria con questi dati; pertanto, IHttpContext i client non devono rilasciare, delete chiamare o tentare di eseguire il downcast e chiamare IDispensedHttpModuleContextContainer::ReleaseContainer il puntatore restituito IHttpModuleContextContainer quando questi dati non sono più necessari.

Esempio

Nell'esempio di codice seguente viene illustrata una classe personalizzata denominata MyContainer che implementa l'interfaccia e una classe personalizzata denominata MyClass che implementa l'interfaccia IDispensedHttpModuleContextContainerIHttpContext. MyClass gestisce un puntatore durante la durata di un MyContainerMyClass puntatore.

// 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  
// IHttpContext interface.  
class MyClass : public IHttpContext  
{  
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 IHttpContext  
    // pure virtual methods if this class  
    // is not abstract.  
  
private:  
    // Specify a private  
    // IDispensedHttpModuleContextContainer  
    // pointer.  
    IDispensedHttpModuleContextContainer* m_container;  
};  

Requisiti

Tipo	Descrizione
Client	- IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10
Server	- IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016
Prodotto	- 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
Intestazione	Httpserv.h

Vedere anche

Interfaccia IHttpContext
Metodo IHttpApplication::GetModuleContextContainer
Metodo IHttpConnection::GetModuleContextContainer
Metodo IHttpFileInfo::GetModuleContextContainer
Metodo IHttpFileMonitor::GetModuleContextContainer
Metodo IHttpSite::GetModuleContextContainer
Metodo IHttpUrlInfo::GetModuleContextContainer
Metodo IMetadataInfo::GetModuleContextContainer