CGlobalModule 클래스

전역 수준 HTTP 모듈의 기본 클래스를 정의합니다.

구문

class CGlobalModule  

메서드

다음 표에서는 클래스에서 노출하는 메서드를 나열합니다 CGlobalModule .

속성	Description
OnGlobalApplicationPreload	deddc775-1ab0-492c-bda0-b32be5d4f4cc
OnGlobalApplicationResolveModules	IIS가 등록된 모듈을 GlobalApplicationResolveModules 확인할 때 발생하는 이벤트를 처리할 메서드를 나타냅니다.
OnGlobalApplicationStart	IIS가 애플리케이션을 GlobalApplicationStart 시작할 때 발생하는 이벤트를 처리할 메서드를 나타냅니다.
OnGlobalApplicationStop	IIS가 애플리케이션을 GlobalApplicationStop 종료할 때 발생하는 이벤트를 처리할 메서드를 나타냅니다.
OnGlobalCacheCleanup	GlobalCacheCleanup 이벤트를 처리할 메서드를 나타냅니다.
OnGlobalCacheOperation	IIS가 캐시 관련 작업을 수행할 때 발생하는 이벤트를 처리 GlobalCacheOperation 할 메서드를 나타냅니다.
OnGlobalConfigurationChange	구성 파일을 변경할 때 발생하는 이벤트를 처리 GlobalConfigurationChange 할 메서드를 나타냅니다.
OnGlobalCustomNotification	모듈이 사용자 정의 알림을 발생시킬 때 발생하는 이벤트를 처리 GlobalCustomNotification 할 메서드를 나타냅니다.
OnGlobalFileChange	웹 사이트 내의 파일이 변경될 때 발생하는 이벤트를 처리 GlobalFileChange 할 메서드를 나타냅니다.
OnGlobalHealthCheck	상태 관련 작업이 실행될 때 발생하는 이벤트를 처리 GlobalHealthCheck 할 메서드를 나타냅니다.
OnGlobalPreBeginRequest	요청이 파이프라인에 들어가기 전에 발생하는 이벤트를 처리 GlobalPreBeginRequest 할 메서드를 나타냅니다.
OnGlobalRSCAQuery	Run-Time 상태 및 제어 쿼리가 GlobalRSCAQuery 실행될 때 발생하는 이벤트를 처리할 메서드를 나타냅니다.
OnGlobalStopListening	IIS가 새 요청 수락을 GlobalStopListening 중지할 때 발생하는 이벤트를 처리할 메서드를 나타냅니다.
OnGlobalThreadCleanup	IIS가 스레드 풀에 스레드를 GlobalThreadCleanup 반환할 때 발생하는 이벤트를 처리할 메서드를 나타냅니다.
OnGlobalTraceEvent	추적 이벤트가 발생할 때 발생하는 이벤트를 처리 GlobalTraceEvent 할 메서드를 나타냅니다.
Terminate	전역 모듈에서 처리를 완료할 때 IIS에서 호출하는 메서드를 나타냅니다.

파생 클래스

이 클래스에는 파생 클래스가 없습니다.

설명

클래스는 CGlobalModule 전역 수준 HTTP 모듈의 기본 클래스입니다. 전역 수준 HTTP 모듈에는 에서 CGlobalModule상속되는 클래스가 포함되어야 합니다. CGlobalModule 는 IIS 7이 전역 수준 이벤트가 발생할 때 전역 수준 알림을 처리하기 위해 호출하는 메서드를 정의합니다. HTTP 모듈은 모듈의 내보낸 RegisterModule 함수에서 알림 목록을 정의하여 특정 이벤트에 등록할 수 있습니다. 전역 수준 모듈의 처리가 완료되면 모듈은 CGlobalModule::Terminate 메서드를 사용하여 메모리에서 인스턴스를 제거 CGlobalModule 해야 합니다.

예제

다음 코드 예제에서는 간단한 "헬로 월드" 전역 수준 HTTP 모듈을 만드는 방법을 보여 줍니다. 모듈은 에서 CGlobalModule파생된 클래스의 instance 만드는 내보낸 RegisterModule 함수를 정의합니다. 클래스를 만들 수 없는 경우 함수는 오류 코드와 함께 종료됩니다. 그렇지 않으면 함수는 IHttpModuleRegistrationInfo::SetRequestNotifications 메서드를 호출하여 GL_PRE_BEGIN_REQUEST 알림에 등록합니다.

알림이 GL_PRE_BEGIN_REQUEST 발생하면 IIS는 모듈의 CGlobalModule::OnGlobalPreBeginRequest 메서드를 호출하여 알림을 처리합니다. 메서드는 프라이빗 메서드를 호출하여 이벤트 뷰어 애플리케이션 로그에 이벤트를 작성한 다음 GL_NOTIFICATION_CONTINUE 반환하여 IIS에 다른 알림을 계속 처리하도록 알립니다. 처리가 완료되면 IIS는 모듈의 CGlobalModule::Terminate 메서드를 호출하여 메모리에서 클래스를 제거합니다.

#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 );
}

모듈은 RegisterModule 함수를 내보내야 합니다. 프로젝트에 대한 모듈 정의(.def) 파일을 만들어 이 함수를 내보내거나 스위치를 사용하여 모듈을 /EXPORT:RegisterModule 컴파일할 수 있습니다. 자세한 내용은 연습: 네이티브 코드를 사용하여 Global-Level HTTP 모듈 만들기를 참조하세요.

필요에 따라 각 함수에 대한 호출 규칙을 명시적으로 선언하는 대신 호출 규칙을 사용하여 __stdcall (/Gz) 코드를 컴파일할 수 있습니다.

요구 사항

형식	Description
클라이언트	- Windows Vista의 IIS 7.0 - Windows 7의 IIS 7.5 - Windows 8의 IIS 8.0 - WINDOWS 10 IIS 10.0
서버	- Windows Server 2008의 IIS 7.0 - Windows Server 2008 R2의 IIS 7.5 - Windows Server 2012의 IIS 8.0 - Windows Server 2012 R2의 IIS 8.5 - WINDOWS SERVER 2016 IIS 10.0
제품	- 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
헤더	Httpserv.h

참고 항목

웹 서버 코어 클래스
Native-Code HTTP 모듈 만들기
CHttpModule 클래스