CGlobalModule::OnGlobalApplicationResolveModules-Methode

Stellt die Methode dar, die ein GlobalApplicationResolveModules Ereignis behandelt, das auftritt, wenn IIS die registrierten Module auflöst.

Syntax

virtual GLOBAL_NOTIFICATION_STATUS OnGlobalApplicationResolveModules(  
   IN IHttpApplicationResolveModulesProvider* pProvider  
);  

Parameter

pProvider
[IN] Ein Zeiger auf eine IHttpApplicationResolveModulesProvider-Schnittstelle .

Rückgabewert

Ein GLOBAL_NOTIFICATION_STATUS Wert.

Hinweise

Wenn ein globales Modul für die GL_APPLICATION_RESOLVE_MODULES Ereignisbenachrichtigung registriert wurde, ruft IIS die Methode des Moduls OnGlobalApplicationResolveModules auf, wenn IIS die Module für eine Anwendung auflöst.

Hinweis

Globale Module können sich für die GlobalApplicationResolveModules Ereignisbenachrichtigung registrieren, indem sie sich in der RegisterModule-Funktion des Moduls registrierenGL_APPLICATION_RESOLVE_MODULES.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie ein HTTP-Modul auf globaler Ebene erstellt wird, das sich für die GL_APPLICATION_RESOLVE_MODULES Benachrichtigung registriert. Wenn IIS die Module für eine Anwendung auflöst, ruft IIS die Methode des Beispielmoduls OnGlobalApplicationResolveModules auf. Diese Methode schreibt einen Eintrag in das Anwendungsprotokoll der Windows-Ereignisanzeige und beendet dann.

#define _WINSOCKAPI_
#include <windows.h>
#include <sal.h>
#include <httpserv.h>

// Create the module's global class.
class MyGlobalModule : public CGlobalModule
{
public:

    // Process a GL_APPLICATION_RESOLVE_MODULES notification.
    GLOBAL_NOTIFICATION_STATUS
    OnGlobalApplicationResolveModules(
        IN IHttpApplicationResolveModulesProvider * pProvider
    )
    {
        UNREFERENCED_PARAMETER( pProvider );
        WriteEventViewerLog("OnGlobalApplicationResolveModules");
        return GL_NOTIFICATION_CONTINUE;
    }

    VOID Terminate()
    {
        // Remove the class from memory.
        delete this;
    }

    MyGlobalModule()
    {
        // Open a handle to the Event Viewer.
        m_hEventLog = RegisterEventSource( NULL,"IISADMIN" );
    }

    ~MyGlobalModule()
    {
        // Test whether the handle for the Event Viewer is open.
        if (NULL != m_hEventLog)
        {
            // Close the handle to the Event Viewer.
            DeregisterEventSource( m_hEventLog );
            m_hEventLog = NULL;
        }
    }

private:

    // Create a handle for the event viewer.
    HANDLE m_hEventLog;

    // Define a method that writes to the Event Viewer.
    BOOL WriteEventViewerLog(LPCSTR szNotification)
    {
        // Test whether the handle for the Event Viewer is open.
        if (NULL != m_hEventLog)
        {
            // Write any strings to the Event Viewer and return.
            return ReportEvent(
                m_hEventLog,
                EVENTLOG_INFORMATION_TYPE, 0, 0,
                NULL, 1, 0, &szNotification, NULL );
        }
        return FALSE;
    }
};

// Create the module's exported registration function.
HRESULT
__stdcall
RegisterModule(
    DWORD dwServerVersion,
    IHttpModuleRegistrationInfo * pModuleInfo,
    IHttpServer * pGlobalInfo
)
{
    UNREFERENCED_PARAMETER( dwServerVersion );
    UNREFERENCED_PARAMETER( pGlobalInfo );

    // Create an instance of the global module class.
    MyGlobalModule * pGlobalModule = new MyGlobalModule;
    // Test for an error.
    if (NULL == pGlobalModule)
    {
        return HRESULT_FROM_WIN32(ERROR_NOT_ENOUGH_MEMORY);
    }
    // Set the global notifications and exit.
    return pModuleInfo->SetGlobalNotifications(
        pGlobalModule, GL_APPLICATION_RESOLVE_MODULES );
}

Ihr Modul muss die Funktion RegisterModule exportieren. Sie können diese Funktion exportieren, indem Sie eine Moduldefinitionsdatei (.def) für Ihr Projekt erstellen, oder Sie können das Modul mithilfe des /EXPORT:RegisterModule Switches kompilieren. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Global-Level HTTP-Moduls mithilfe von nativem Code.

Sie können den Code optional kompilieren, indem Sie die __stdcall (/Gz) aufrufende Konvention verwenden, anstatt die aufrufende Konvention für jede Funktion explizit zu deklarieren.

Anforderungen

Typ	BESCHREIBUNG
Client	– IIS 7.0 unter Windows Vista – IIS 7.5 unter Windows 7 – IIS 8.0 auf Windows 8 – IIS 10.0 auf Windows 10
Server	– IIS 7.0 unter Windows Server 2008 – IIS 7.5 unter Windows Server 2008 R2 – IIS 8.0 auf Windows Server 2012 – IIS 8.5 auf Windows Server 2012 R2 – IIS 10.0 auf Windows Server 2016
Produkt	– 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
Header	Httpserv.h

Weitere Informationen

CGlobalModule-Klasse