Enumerazione GLOBAL_NOTIFICATION_STATUS

Articolo
07/19/2023

Definisce i valori restituiti per le notifiche a livello globale.

Sintassi

typedef enum GLOBAL_NOTIFICATION_STATUS{  
   GL_NOTIFICATION_CONTINUE,  
   GL_NOTIFICATION_HANDLED  
};

Members

Nome del membro	Descrizione
`GL_NOTIFICATION_CONTINUE`	Indica che IIS deve continuare a elaborare notifiche aggiuntive a livello globale.
`GL_NOTIFICATION_HANDLED`	Indica che IIS ha completato l'elaborazione delle notifiche a livello globale e non deve elaborare notifiche aggiuntive a livello globale.

Commenti

I membri dell'enumerazione GLOBAL_NOTIFICATION_STATUS vengono usati come valori restituiti dalle notifiche a livello globale e i membri consentono di controllare il flusso del processo all'interno della pipeline di elaborazione delle notifiche a livello globale. Ad esempio, la restituzione GL_NOTIFICATION_CONTINUE da un gestore di notifica a livello globale indica a IIS di continuare a elaborare notifiche a livello globale aggiuntive, mentre la GL_NOTIFICATION_HANDLED restituzione da un gestore di notifica a livello globale informa IIS che l'elaborazione a livello globale è stata completata e IIS non deve elaborare notifiche aggiuntive a livello globale.

Esempio

Nell'esempio di codice seguente viene illustrato come creare un semplice modulo HTTP a livello globale "Hello World". Il modulo definisce una funzione RegisterModule esportata che crea un'istanza di una classe derivata da CGlobalModule. Se la classe non può essere creata, la funzione viene chiusa con un codice di errore; in caso contrario, la funzione chiama il metodo IHttpModuleRegistrationInfo::SetRequestNotifications per eseguire la registrazione per la notifica di GL_PRE_BEGIN_REQUEST .

Quando si verifica una GL_PRE_BEGIN_REQUEST notifica, IIS chiama il metodo CGlobalModule::OnGlobalPreBeginRequest del modulo per elaborare la notifica. Il metodo chiama un metodo privato per scrivere un evento nel registro applicazioni del Visualizzatore eventi e quindi torna GL_NOTIFICATION_CONTINUE a notificare a IIS di continuare l'elaborazione di altre notifiche. Al termine dell'elaborazione, IIS chiama il metodo CGlobalModule::Terminate del modulo per rimuovere la classe dalla 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 );
}

Il modulo deve esportare la RegisterModule funzione. È possibile esportare questa funzione creando un file di definizione del modulo (con estensione def) per il progetto oppure è possibile compilare il modulo usando l'opzione /EXPORT:RegisterModule . Per altre informazioni, vedere Procedura dettagliata: Creazione di un modulo HTTP Global-Level tramite codice nativo.

Facoltativamente, è possibile compilare il codice usando la __stdcall (/Gz) convenzione di chiamata anziché dichiarare in modo esplicito la convenzione di chiamata per ogni funzione.

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

Enumerazioni Web Server Core
Enumerazione REQUEST_NOTIFICATION_STATUS

Condividi tramite