Метод CHttpModule::OnMapPath

Статья
07/19/2023

Представляет метод, который будет обрабатывать MapPath событие, которое происходит, когда операция запрашивает физический путь для сопоставления с текущим запросом.

Синтаксис

virtual REQUEST_NOTIFICATION_STATUS OnMapPath(  
   IN IHttpContext* pHttpContext,  
   IN IMapPathProvider* pProvider  
);

Параметры

pHttpContext
[IN] Указатель на интерфейс IHttpContext .

pProvider
[IN] Указатель на интерфейс IMapPathProvider .

Возвращаемое значение

Значение REQUEST_NOTIFICATION_STATUS .

Когда модуль уровня запроса зарегистрирован для уведомления RQ_MAP_PATH , СЛУЖБЫ IIS вызовет метод модуля OnMapPath , когда операция запрашивает физический путь для сопоставления с текущим запросом.

Примечание

Модули уровня запроса можно зарегистрировать для уведомления о событии MapPath , зарегистрировав для RQ_MAP_PATH в функции RegisterModule модуля.

Пример

В следующем примере кода показано, как создать http-модуль уровня запроса, который регистрирует уведомления о RQ_MAP_PATH событиях. Когда операция запрашивает сопоставление физического пути с текущим запросом, СЛУЖБЫ IIS вызовет метод примера модуля OnMapPath .

//  Insert data from ostringstream into the response
//  On error, Provider error status set here
//  ostringstream  buffer cleared for next call 

HRESULT  WECbyRefChunk( std::ostringstream  &os, IHttpContext *pHttpContext, 
                       IHttpEventProvider *pProvider, LONG InsertPosition= -1)
{
    HRESULT hr = S_OK;

    IHttpTraceContext * pTraceContext = pHttpContext->GetTraceContext();

    hr = pTraceContext->QuickTrace(L"WECbyRefChunk",L"data 2",E_FAIL,6);
    if (FAILED(hr)){
        LOG_ERR_HR(hr,"QuickTrace");
        return hr;
    }
    // create convenience string from ostringstream  
    std::string str(os.str());

    HTTP_DATA_CHUNK dc;
    dc.DataChunkType = HttpDataChunkFromMemory;
    dc.FromMemory.BufferLength = static_cast<DWORD>(str.size());
    dc.FromMemory.pBuffer = pHttpContext->AllocateRequestMemory( 
        static_cast<DWORD>( str.size()+1) );

    if(!dc.FromMemory.pBuffer){
        hr = HRESULT_FROM_WIN32(ERROR_NOT_ENOUGH_MEMORY);
        LOG_ERR_HR(hr,"AllocateRequestMemory");
        pProvider->SetErrorStatus(hr);
        return hr;
    }

    //  use char pointer p for convenience
    char *p = static_cast<char *>(dc.FromMemory.pBuffer);
    strcpy_s(p, str.size()+1, str.c_str());

    hr = pHttpContext->GetResponse()->WriteEntityChunkByReference( 
        &dc, InsertPosition );

    if (FAILED(hr)){
        LOG_ERR_HR(hr,"AllocateRequestMemory");
        pProvider->SetErrorStatus( hr );
    }

    os.str("");                // clear the ostringstream for next call

    return hr;
}

Требования

Тип	Описание
клиент	— IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 в Windows 10
Сервер	— IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016
Продукт	— 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

См. также:

Класс CHttpModule

Поделиться через