REQUEST_NOTIFICATION_STATUS列挙
要求レベルの通知の戻り値を定義します。
構文
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 され、通常の処理が発生します。 カウンター値の剰余が 0 の場合、要求されたファイルは 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;
}
要件
| Type | 説明 |
|---|---|
| Client | - 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 |
| Header | Httpserv.h |