GLOBAL_NOTIFICATION_STATUS (enumeración)

Define los valores devueltos para las notificaciones de nivel global.

Sintaxis

typedef enum GLOBAL_NOTIFICATION_STATUS{  
   GL_NOTIFICATION_CONTINUE,  
   GL_NOTIFICATION_HANDLED  
};  

Miembros

Nombre del miembro	Descripción
GL_NOTIFICATION_CONTINUE	Indica que IIS debe seguir procesando notificaciones de nivel global adicionales.
GL_NOTIFICATION_HANDLED	Indica que IIS ha terminado de procesar las notificaciones de nivel global y no debe procesar ninguna notificación de nivel global adicional.

Comentarios

Los miembros de la GLOBAL_NOTIFICATION_STATUS enumeración se usan como valores devueltos de las notificaciones de nivel global y los miembros ayudan a controlar el flujo de proceso dentro de la canalización de procesamiento de notificaciones de nivel global. Por ejemplo, si vuelve de un controlador de notificaciones de nivel global, se indica a IIS que siga procesando notificaciones de nivel global adicionales, mientras que cuando se devuelve GL_NOTIFICATION_CONTINUEGL_NOTIFICATION_HANDLED de un controlador de notificaciones de nivel global, se informa a IIS de que el procesamiento de nivel global está completo y IIS no debe procesar notificaciones de nivel global adicionales.

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, vuelve GL_NOTIFICATION_CONTINUE a 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 RegisterModule función. 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

Enumeraciones de Web Server Core
REQUEST_NOTIFICATION_STATUS (enumeración)