IHttpContext::GetIsLastNotification 메서드

현재 모듈 호스트 내에서 이 요청에 대해 더 많은 알림이 보류 중인지 여부를 나타냅니다.

구문

virtual BOOL GetIsLastNotification(  
   IN REQUEST_NOTIFICATION_STATUS status  
) = 0;  

매개 변수

status
[IN] REQUEST_NOTIFICATION_STATUS 열거형 값입니다.

반환 값

true 추가 알림이 보류 중이면 이고, 그렇지 않으면 입니다 false.

설명

메서드는 GetIsLastNotification 현재 모듈 호스트 내에서 현재 요청에 대한 보류 중인 알림의 상태 검색합니다. 즉, 메서드는 GetIsLastNotification 다른 요청에 대해 추가 알림이 보류 중인지 또는 다른 모듈 호스트에서 실행되는 모듈에 대해 추가 알림이 보류 중인지 여부를 나타내지 않습니다.

매개 변수의 status 값은 메서드의 반환 값에 직접 영향을 줍니다 GetIsLastNotification . 예를 들어 RQ_NOTIFICATION_CONTINUE 지정하면 추가 알림이 보류 중임을 나타내기 위해 반환 true 되는 반면, RQ_NOTIFICATION_FINISH_REQUEST 지정하면 동일한 요청에 대해 반환 false 할 수 있습니다. 이 동작은 의 상태 값이 의 RQ_NOTIFICATION_CONTINUE 상태 값 RQ_NOTIFICATION_FINISH_REQUEST 이 무시된다는 추가 알림을 계속 처리하기 때문에 발생합니다.

예제

다음 코드 예제를 사용 GetIsLastNotification 하는 방법을 보여 줍니다.는 현재 요청에 대 한 보류 중인 알림이 더 있는지 여부를 나타내는 HTTP 모듈을 만드는 방법입니다. 그런 다음 모듈은 해당 정보를 웹 클라이언트에 반환합니다.

#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
    )
    {
        UNREFERENCED_PARAMETER( pProvider );

        // Retrieve if this is the last notification.
        BOOL bIsLastNotification;
        bIsLastNotification = pHttpContext->GetIsLastNotification(
            RQ_NOTIFICATION_FINISH_REQUEST);
        
        // 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 string to the client whether this is the last notification.
        WriteResponseMessage(pHttpContext,"Last Notification: ",
            (TRUE==bIsLastNotification)?"Yes":"No");

        // End additional processing.
        return RQ_NOTIFICATION_FINISH_REQUEST;
    }

private:

    // Create a utility method that inserts a name/value pair into the response.
    HRESULT WriteResponseMessage(
        IHttpContext * pHttpContext,
        PCSTR pszName,
        PCSTR pszValue
    )
    {
        // Create an HRESULT to receive return values from methods.
        HRESULT hr;
        
        // Create a data chunk. (Defined in the Http.h file.)
        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 first buffer.
        dataChunk.FromMemory.pBuffer =
            (PVOID) pszName;
        // Set the chunk size to the first buffer size.
        dataChunk.FromMemory.BufferLength =
            (USHORT) strlen(pszName);
        // 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;
        }

        // Set the chunk to the second buffer.
        dataChunk.FromMemory.pBuffer =
            (PVOID) pszValue;
        // Set the chunk size to the second buffer size.
        dataChunk.FromMemory.BufferLength =
            (USHORT) strlen(pszValue);
        // 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 we 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 );

    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

참고 항목

IHttpContext 인터페이스
IHttpContext::D isableNotifications 메서드
IHttpContext::GetNextNotification 메서드