IHttpEventProvider 인터페이스

아티클
07/19/2023

제네릭 이벤트 보고 인터페이스를 제공합니다.

구문

class IHttpEventProvider

메서드

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

속성	Description
SetErrorStatus	반환할 오류를 지정합니다.

파생 클래스

다음 표에서는 인터페이스에서 노출하는 파생 클래스를 IHttpEventProvider 나열합니다.

속성	Description
IAuthenticationProvider	RQ_REQUEST_AUTHENTICATE 이벤트 알림에 대한 인터페이스를 제공합니다.
ICacheProvider	GL_CACHE_OPERATION 이벤트 알림에 대한 인터페이스를 제공합니다.
ICustomNotificationProvider	GL_CUSTOM_NOTIFCATION 및 RQ_CUSTOM_NOTIFCATION 이벤트 알림에 대한 인터페이스를 제공합니다.
IGlobalConfigurationChangeProvider	GL_CONFIGURATION_CHANGE 이벤트 알림에 대한 인터페이스를 제공합니다.
IGlobalFileChangeProvider	GL_FILE_CHANGE 이벤트 알림에 대한 인터페이스를 제공합니다.
IGlobalRSCAQueryProvider	GL_RSCA_QUERY 이벤트 알림에 대한 인터페이스를 제공합니다.
IGlobalStopListeningProvider	GL_STOP_LISTENING 이벤트 알림에 대한 인터페이스를 제공합니다.
IGlobalThreadCleanupProvider	GL_THREAD_CLEANUP 이벤트 알림에 대한 인터페이스를 제공합니다.
IGlobalTraceEventProvider	GL_TRACE_EVENT 이벤트 알림에 대한 인터페이스를 제공합니다.
IHttpApplicationProvider	GL_APPLICATION_START 이벤트 알림에 대한 인터페이스를 제공합니다.
IMapHandlerProvider	RQ_DETERMINE_HANDLER 이벤트 알림에 대한 인터페이스를 제공합니다.
IMapPathProvider	RQ_MAP_PATH 이벤트 알림에 대한 인터페이스를 제공합니다.
IPreBeginRequestProvider	GL_PRE_BEGIN_REQUEST 이벤트 알림에 대한 인터페이스를 제공합니다.
IReadEntityProvider	RQ_READ_ENTITY 이벤트 알림에 대한 인터페이스를 제공합니다.
ISendResponseProvider	RQ_SEND_RESPONSE 이벤트 알림에 대한 인터페이스를 제공합니다.

설명

인터페이스는 IHttpEventProvider 대부분의 알림 메서드에 대한 제네릭 이벤트 보고 인터페이스를 제공하며 나머지 알림과 함께 사용되는 이벤트 보고 인터페이스의 부모 클래스 역할을 합니다.

인터페이스는 IHttpEventProvider 현재 컨텍스트에 대한 오류 상태 설정하는 SetErrorStatus 메서드만 노출합니다. 에서 상속 IHttpEventProvider 되는 파생 클래스 중 일부는 해당 이벤트와 관련된 추가 메서드를 노출합니다.

예제

다음 코드 예제에서는 예제 문자열을 웹 클라이언트에 보내고 이 작업의 반환 값을 캡처하는 HTTP 모듈을 만드는 방법을 보여 줍니다. 모듈은 메서드를 SetErrorStatus 사용하여 반환 값을 현재 요청에 대한 오류 상태 지정한 다음 종료합니다.

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

// Create the module class.
class MyHttpModule : public CHttpModule
{
public:
    REQUEST_NOTIFICATION_STATUS
    OnBeginRequest(
        IN IHttpContext * pHttpContext,
        IN IHttpEventProvider * pProvider
    )
    {
        // Create an HRESULT to receive return values from methods.
        HRESULT hr;

        // Clear the existing response.
        pHttpContext->GetResponse()->Clear();
        // Set the MIME type to plain text.
        pHttpContext->GetResponse()->SetHeader(
            HttpHeaderContentType,"text/plain",
            (USHORT)strlen("text/plain"),TRUE);

        // Return a simple message to the Web client.
        hr = WriteResponseMessage(pHttpContext,"Hello World!");

        // Set the error status for the module.
        pProvider->SetErrorStatus( hr );

        // End additional processing.
        return RQ_NOTIFICATION_FINISH_REQUEST;
    }

private:

    // Create a utility method that inserts a string value into the response.
    HRESULT WriteResponseMessage(
        IHttpContext * pHttpContext,
        PCSTR pszBuffer
    )
    {
        // Create an HRESULT to receive return values from methods.
        HRESULT hr;
        
        // Create a data chunk.
        HTTP_DATA_CHUNK dataChunk;
        // Set the chunk to a chunk in memory.
        dataChunk.DataChunkType = HttpDataChunkFromMemory;
        // Buffer for bytes written of data chunk.
        DWORD cbSent;

        // Set the chunk to the buffer.
        dataChunk.FromMemory.pBuffer =
            (PVOID) pszBuffer;
        // Set the chunk size to the buffer size.
        dataChunk.FromMemory.BufferLength =
            (USHORT) strlen(pszBuffer);
        // Insert the data chunk into the response.
        hr = pHttpContext->GetResponse()->WriteEntityChunks(
            &dataChunk,1,FALSE,TRUE,&cbSent);
        // Test for an error.
        if (FAILED(hr))
        {
            // Return the error status.
            return hr;
        }

        // Return a success status.
        return S_OK;
    }
};

// Create the module's class factory.
class MyHttpModuleFactory : public IHttpModuleFactory
{
public:
    HRESULT
    GetHttpModule(
        OUT CHttpModule ** ppModule, 
        IN IModuleAllocator * pAllocator
    )
    {
        UNREFERENCED_PARAMETER( pAllocator );

        // Create a new instance.
        MyHttpModule * pModule = new MyHttpModule;

        // Test for an error.
        if (!pModule)
        {
            // Return an error if the factory cannot create the instance.
            return HRESULT_FROM_WIN32( ERROR_NOT_ENOUGH_MEMORY );
        }
        else
        {
            // Return a pointer to the module.
            *ppModule = pModule;
            pModule = NULL;
            // Return a success status.
            return S_OK;
        }            
    }

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

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

    // Set the request notifications and exit.
    return pModuleInfo->SetRequestNotifications(
        new MyHttpModuleFactory,
        RQ_BEGIN_REQUEST,
        0
    );
}

모듈은 RegisterModule 함수를 내보내야 합니다. 프로젝트에 대한 모듈 정의(.def) 파일을 만들어 이 함수를 내보내거나 스위치를 사용하여 모듈을 /EXPORT:RegisterModule 컴파일할 수 있습니다. 자세한 내용은 연습: 네이티브 코드를 사용하여 Request-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

참고 항목

다음을 통해 공유

IHttpEventProvider 인터페이스

구문

메서드

파생 클래스

설명

예제

요구 사항

참고 항목

피드백

추가 리소스