Перечисление REQUEST_NOTIFICATION_STATUS

Статья
07/19/2023

Определяет возвращаемые значения для уведомлений уровня запроса.

Синтаксис

typedef enum REQUEST_NOTIFICATION_STATUS{  
   RQ_NOTIFICATION_CONTINUE,  
   RQ_NOTIFICATION_PENDING,  
   RQ_NOTIFICATION_FINISH_REQUEST  
};

Члены

Имя участника	Описание
`RQ_NOTIFICATION_CONTINUE`	Указывает, что СЛУЖБЫ IIS должны продолжать обработку дополнительных уведомлений уровня запроса.
`RQ_NOTIFICATION_PENDING`	Указывает, что асинхронное уведомление находится в состоянии ожидания и возвращает обработку на уровне запроса в IIS.
`RQ_NOTIFICATION_FINISH_REQUEST`	Указывает, что службы IIS завершили обработку уведомлений уровня запроса и не должны обрабатывать дополнительные уведомления уровня запроса.

Члены перечисления REQUEST_NOTIFICATION_STATUS используются в качестве возвращаемых значений из уведомлений уровня запроса, а члены помогают управлять потоком процесса в интегрированном конвейере обработки запросов. Например, возврат RQ_NOTIFICATION_CONTINUE из обработчика уведомлений на уровне запроса предписывает СЛУЖБАм IIS продолжить обработку дополнительных уведомлений на уровне запроса, тогда как возврат RQ_NOTIFICATION_FINISH_REQUEST из обработчика уведомлений уровня запроса информирует IIS о том, что обработка на уровне запроса завершена, и IIS не должны обрабатывать дополнительные уведомления на уровне запроса. Модули, реализующие обработку запросов, должны возвращать при RQ_NOTIFICATION_FINISH_REQUEST возникновении ошибки.

Пример

В следующем примере реализуется RQ_BEGIN_REQUEST обработчик . Если запрос не является HTML-файлом, возвращается RQ_NOTIFICATION_CONTINUE пример и выполняется обычная обработка. Если значение счетчика имеет нулевой остаток, запрошенный файл заменяется строкой, возвращаемой методом IHttpResponse::WriteEntityChunkByReference , а в примере возвращается RQ_NOTIFICATION_FINISH_REQUEST. Если возникает ошибка, в примере ошибка регистрируется и возвращается RQ_NOTIFICATION_FINISH_REQUEST.

REQUEST_NOTIFICATION_STATUS
CMyHttpModule::OnBeginRequest(
    IHttpContext*       pHttpContext,
    IHttpEventProvider* pProvider
)
{
    HRESULT hr;

    static long cnt;
    InterlockedIncrement(&cnt);  // keep track of how many times we are called
    cnt++;

    IHttpRequest *pRequest = pHttpContext->GetRequest();
    PCWSTR url = pRequest->GetRawHttpRequest()->CookedUrl.pAbsPath;
    OutputDebugStringW(url);

    // return unless requesting a HTML file

    if (!wcsstr(url, L".htm"))
        return RQ_NOTIFICATION_CONTINUE;

    IHttpResponse * pHttpResponse = pHttpContext->GetResponse();

    // Return most times so we can still view content
    if ((cnt % 5) || pHttpResponse == NULL)
        return RQ_NOTIFICATION_CONTINUE;

    TRC_MSG_FULL("HTML  cnt = " << cnt);

    static int insertPosCnt;
    int insertPos = ++insertPosCnt % 2 - 1;    // toggle between 0 and -1

    // Use ostringstream to create some dynamic content
    std::ostringstream os;

    os << "<p /> first chunk  callback count = " << cnt
        << " insertPos = " << insertPos << "<br />";

    // 
    // WECbyRefChunk does all the work of inserting data into the response
    //

    hr = WECbyRefChunk(os, pHttpContext, pProvider, insertPos);
    if (FAILED(hr))
        return RQ_NOTIFICATION_FINISH_REQUEST;

    os << "<br /> <b> Adding 2nd chunk in Bold </b> File insertPos = " << insertPos;
    hr = WECbyRefChunk(os, pHttpContext, pProvider, insertPos);
    if (FAILED(hr))
        return RQ_NOTIFICATION_FINISH_REQUEST;

    os << " <p /> Last (3rd) Chunk added with default append chunk  GetCurrentThreadId = "
        << GetCurrentThreadId();

    // any errors will be logged/handled in  WECbyRefChunk
    WECbyRefChunk(os, pHttpContext, pProvider);

    // End additional processing, not because of error, but so another request
    // (from a GIF or .css style sheet on the same HTML page)
    // doesn't wipe out our WriteEntityChunkByReference. We can also get the
    // WriteEntityChunkByReference prepended to our normal HTML page. 

    return RQ_NOTIFICATION_FINISH_REQUEST;

}

HRESULT hr = S_OK;

IHttpTraceContext * pTraceContext = pHttpContext->GetTraceContext();
hr = My_Events::My_COMPLETION::RaiseEvent(pTraceContext, InsertPosition);
if (FAILED(hr)) {
    LOG_ERR_HR(hr, "RaiseEvent");
    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

См. также:

Перечисления основных веб-серверов
Перечисление GLOBAL_NOTIFICATION_STATUS

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