CGlobalModule (clase)

Define la clase base para los módulos HTTP de nivel global.

Sintaxis

class CGlobalModule  

Métodos

En la tabla siguiente se enumeran los métodos expuestos por la CGlobalModule clase .

Nombre	Descripción
OnGlobalApplicationPreload	deddc775-1ab0-492c-bda0-b32be5d4f4cc
OnGlobalApplicationResolveModules	Representa el método que controlará un GlobalApplicationResolveModules evento, que se produce cuando IIS resuelve los módulos registrados.
OnGlobalApplicationStart	Representa el método que controlará un GlobalApplicationStart evento, que se produce cuando IIS inicia una aplicación.
OnGlobalApplicationStop	Representa el método que controlará un GlobalApplicationStop evento, que se produce cuando IIS cierra una aplicación.
OnGlobalCacheCleanup	Representa el método que procesará un evento GlobalCacheCleanup.
OnGlobalCacheOperation	Representa el método que controlará un GlobalCacheOperation evento, que se produce cuando IIS realiza una operación relacionada con la memoria caché.
OnGlobalConfigurationChange	Representa el método que controlará un GlobalConfigurationChange evento, que se produce cuando se realiza un cambio en un archivo de configuración.
OnGlobalCustomNotification	Representa el método que controlará un GlobalCustomNotification evento, que se produce cuando un módulo genera una notificación definida por el usuario.
OnGlobalFileChange	Representa el método que controlará un GlobalFileChange evento, que se produce cuando se cambia un archivo dentro de un sitio web.
OnGlobalHealthCheck	Representa el método que controlará un GlobalHealthCheck evento, que se produce cuando se ejecuta una operación relacionada con el estado.
OnGlobalPreBeginRequest	Representa el método que controlará un GlobalPreBeginRequest evento, que se produce antes de que una solicitud entre en la canalización.
OnGlobalRSCAQuery	Representa el método que controlará un GlobalRSCAQuery evento, que se produce cuando se ejecuta una consulta de estado y control de Run-Time.
OnGlobalStopListening	Representa el método que controlará un GlobalStopListening evento, que se produce cuando IIS deja de aceptar nuevas solicitudes.
OnGlobalThreadCleanup	Representa el método que controlará un GlobalThreadCleanup evento, que se produce cuando IIS devuelve un subproceso al grupo de subprocesos.
OnGlobalTraceEvent	Representa el método que controlará un GlobalTraceEvent evento, que se produce cuando se genera un evento de seguimiento.
Terminate	Representa el método al que IIS llama cuando un módulo global ha completado el procesamiento.

Clases derivadas

Esta clase no contiene clases derivadas.

Comentarios

La CGlobalModule clase es la clase base para los módulos HTTP de nivel global. Los módulos HTTP de nivel global deben contener una clase que herede de CGlobalModule. CGlobalModule define los métodos a los que IIS 7 llama para controlar las notificaciones de nivel global cuando se producen eventos de nivel global. Un módulo HTTP puede registrarse para eventos específicos mediante la definición de una lista de notificaciones en la función RegisterModule exportada de un módulo. Cuando un módulo de nivel global ha terminado de procesarse, el módulo debe usar el método CGlobalModule::Terminate para quitar CGlobalModule instancias de la memoria.

Ejemplo

En el ejemplo de código siguiente se muestra cómo crear un sencillo módulo HTTP de nivel global de "Hola mundo". El módulo define una función RegisterModule exportada que crea una instancia de una clase derivada de CGlobalModule. Si no se puede crear la clase, la función sale con un código de error; De lo contrario, la función llama al método IHttpModuleRegistrationInfo::SetRequestNotifications para registrarse para la notificación de GL_PRE_BEGIN_REQUEST .

Cuando se produce una GL_PRE_BEGIN_REQUEST notificación, IIS llama al método CGlobalModule::OnGlobalPreBeginRequest del módulo para procesar la notificación. El método llama a un método privado para escribir un evento en el registro de la aplicación del Visor de eventos y, a continuación, devuelve GL_NOTIFICATION_CONTINUE para notificar a IIS que continúe procesando otras notificaciones. Cuando se completa el procesamiento, IIS llama al método CGlobalModule::Terminate del módulo para quitar la clase de la memoria.

#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_START notification.
    GLOBAL_NOTIFICATION_STATUS
    OnGlobalPreBeginRequest(
        IN IPreBeginRequestProvider * pProvider
    )
    {
        UNREFERENCED_PARAMETER( pProvider );
        WriteEventViewerLog( "Hello World!" );
        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_PRE_BEGIN_REQUEST );
}

El módulo debe exportar la función RegisterModule . Puede exportar esta función mediante la creación de un archivo de definición de módulo (.def) para el proyecto, o bien puede compilar el módulo mediante el /EXPORT:RegisterModule modificador . Para obtener más información, vea Tutorial: Creación de un módulo HTTP de Global-Level mediante código nativo.

Opcionalmente, puede compilar el código mediante la __stdcall (/Gz) convención de llamada en lugar de declarar explícitamente la convención de llamada para cada función.

Requisitos

Tipo	Descripción
Remoto	- IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10
Servidor	- IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016
Producto	- 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
Encabezado	Httpserv.h

Consulte también

Clases básicas de servidor web
Creación de módulos HTTP de Native-Code
CHttpModule (clase)