HTTP_TRACE_EVENT構造体
トレース プロバイダーから返されるトレース情報が含まれます。
構文
struct HTTP_TRACE_EVENT{
LPCGUID pProviderGuid;
DWORD dwArea;
LPCGUID pAreaGuid;
DWORD dwEvent;
LPCWSTR pszEventName;
DWORD dwEventVersion;
DWORD dwVerbosity;
LPCGUID pActivityGuid;
LPCGUID pRelatedActivityGuid;
DWORD dwTimeStamp;
DWORD dwFlags;
DWORD cEventItems;
__field_ecount(cEventItems) HTTP_TRACE_EVENT_ITEM * pEventItems;
};
メンバー
メンバー名 | 説明 |
---|---|
pProviderGuid |
LPCGUID プロバイダーの識別子を格納している 。 使用可能な値には、「トレース 定数」で定義されているトレース GUID セクションの値が含まれますが、これらに限定されません。 |
dwArea |
DWORD イベントの対象領域を格納している 。 面積の値は正の整数である必要があります。 |
pAreaGuid |
LPCGUID 対象領域を示す 。 |
dwEvent |
DWORD イベント プロバイダーのイベントの一意識別子を格納している 。 |
pszEventName |
LPCWSTR イベントの名前を格納している 。 この値は、イベントの種類の説明を示すためにイベント プロバイダーによって設定されます。 |
dwEventVersion |
DWORD イベントのバージョンを格納している 。 通常は 0 または 1 ですが、負でない整数値を含めることができます。 |
dwVerbosity |
DWORD 数値を詳細に対応する値にマップする (値 0 から 5 は General、FatalError、Error、Warning、Info、Verbose にマップされます)。 |
pActivityGuid |
LPCGUID 一意の要求識別子を格納している 。 |
pRelatedActivityGuid |
LPCGUID 関連するアクティビティを関連付ける値を格納している 。 ほとんどのプロバイダーでは、この値を NULL に設定し、イベント リスナーにイベントを送信する前に IIS が値を設定できるようにします。 |
dwTimeStamp |
DWORD 内部ティック数で表される省略可能なタイム スタンプを含む 。 |
dwFlags |
DWORD 追加のフラグを含む 。 ほとんどのプロバイダーでは、この値をHTTP_TRACE_EVENT_FLAG_STATIC_DESCRIPTIVE_FIELDSに設定します。「トレース定数」で定義されている「 トレース定数」セクションで説明されています。 |
cEventItems |
DWORD 配列内の要素の数を格納している pEventItems 。 |
pEventItems |
長さのcEventItems 構造体HTTP_TRACE_EVENT_ITEM構造体の配列。 |
解説
構造体のほとんどのメンバーは、 HTTP_TRACE_EVENT
Windows イベント トレーシング (ETW) イベントに直接マップされます。 dwArea
メンバーと pAreaGuid
メンバーは IIS に固有です。
GL_TRACE_EVENTイベント型に登録する CGlobalModule 派生クラスは、CGlobalModule::OnGlobalTraceEvent 純粋virtual
メソッドのパラメーターとして IGlobalTraceEventProvider ポインターを受け取ります。 その後、NULL HTTP_TRACE_EVENT
構造体のアドレスへのポインターを指定する IGlobalTraceEventProvider::GetTraceEvent メソッドを呼び出すことで、ポインターを取得HTTP_TRACE_EVENT
できます。
詳細については、「 トレース定数」を参照してください。
dwArea
メンバーと pAreaGuid
メンバーには、イベントの対象領域に対して 2 つの異なる定数が含まれています。
例
次の例では、 構造体を HTTP_TRACE_EVENT
設定し、 IHttpTraceContext::RaiseTraceEvent メソッドを 呼び出します。
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;
}
class My_Events
{
public:
static LPCGUID GetAreaGuid( VOID ){ // GUID for the event class
static const GUID AreaGuid =
{0xacade3b2,0xb7d7,0x4339,{0x95,0x6c,0x81,0x1b,0x4e,0xdb,0x1b,0x24}};
return &AreaGuid;
};
static LPCGUID GetProviderGuid( VOID ){ // GUID for the event Provider
static const GUID PrvderGuid =
// {EB881638-214A-4f2a-9B39-933770822D18}
{ 0xeb881638, 0x214a, 0x4f2a, { 0x9b, 0x39, 0x93, 0x37, 0x70, 0x82, 0x2d, 0x18 } };
;
return &PrvderGuid;
};
class My_COMPLETION
{
public:
static HRESULT RaiseEvent(
IHttpTraceContext * pHttpTraceContext,
LONG InsertPosition
)
//
// Raise Cmy_COMPLETION Event
//
{
HTTP_TRACE_EVENT Event;
Event.pProviderGuid = My_Events::GetProviderGuid();
Event.dwArea = 1;
Event.pAreaGuid = My_Events::GetAreaGuid();
Event.dwEvent = 1;
Event.pszEventName = L"NOTIFY_MY_CSTM_WECBR_EVNT";
Event.dwEventVersion = 2;
Event.dwVerbosity = 1;
Event.cEventItems = 1;
Event.pActivityGuid = NULL;
Event.pRelatedActivityGuid = NULL;
Event.dwTimeStamp = 0;
Event.dwFlags = HTTP_TRACE_EVENT_FLAG_STATIC_DESCRIPTIVE_FIELDS;
// pActivityGuid, pRelatedActivityGuid, Timestamp to be filled in by IIS
HTTP_TRACE_EVENT_ITEM Items[ 1 ];
Items[ 0 ].pszName = L"InsertPosition";
Items[ 0 ].dwDataType = HTTP_TRACE_TYPE_LONG; // mof type (object)
#pragma warning (disable:4312)
Items[ 0 ].pbData = (PBYTE) InsertPosition;
Items[ 0 ].cbData = 4;
Items[ 0 ].pszDataDescription = L"Insert Position";
Event.pEventItems = Items;
return pHttpTraceContext->RaiseTraceEvent( &Event );
};
};
};
failed-request トレースが正しく構成されている場合は、トレース ログに NOTIFY_MODULE_START
イベントと NOTIFY_MODULE_END
イベントが表示されます。 失敗した要求のログ記録の詳細については、「 IIS 7.0 での失敗した要求のトレースの構成」を参照してください。 次の XML は、 NOTIFY_MODULE_START
失敗した要求トレース ログの部分です。 ほとんどのデータはシステムに依存しており、以下のイベントと一致しません。
<Event xmlns="http://schemas.microsoft.com/win/2004/08/events/event">
<System>
<Provider Name="WWW Server" Guid="{3A2A4E84-4C21-4981-AE10-3FDA0D9B0F83}"/>
<EventID>0</EventID>
<Version>1</Version>
<Level>5</Level>
<Opcode>1</Opcode>
<Keywords>0x100</Keywords>
<TimeCreated SystemTime="2007-08-27T21:10:30.186Z"/>
<Correlation ActivityID="{00000000-0000-0000-9800-0080000000FA}"/>
<Execution ProcessID="1308" ThreadID="3608"/>
<Computer>N2-IIS</Computer>
</System>
<EventData>
<Data Name="ContextId">{00000000-0000-0000-9800-0080000000FA}</Data>
<Data Name="ModuleName">A_raizeEvent</Data>
<Data Name="Notification">1</Data>
<Data Name="fIsPostNotification">false</Data>
<Data Name="fIsCompletion">false</Data>
</EventData>
<RenderingInfo Culture="en-US">
<Opcode>NOTIFY_MODULE_START</Opcode>
<Keywords>
<Keyword>RequestNotifications</Keyword>
</Keywords>
<freb:Description Data="Notification">BEGIN_REQUEST</freb:Description>
</RenderingInfo>
<ExtendedTracingInfo xmlns="http://schemas.microsoft.com/win/2004/08/events/trace">
<EventGuid>{002E91E3-E7AE-44AB-8E07-99230FFA6ADE}</EventGuid>
</ExtendedTracingInfo>
</Event>
要件
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 | Httptrace.h |