EvtCreateRenderContext 関数 (winevt.h)

レンダリングするイベントの情報を指定するコンテキストを作成します。

構文

EVT_HANDLE EvtCreateRenderContext(
  [in] DWORD   ValuePathsCount,
  [in] LPCWSTR *ValuePaths,
  [in] DWORD   Flags
);

[in] ValuePathsCount

ValuePaths パラメーター内の XPath 式の数。

[in] ValuePaths

レンダリングするイベントのノードまたは属性を一意に識別する XPath 式の配列。

EvtRenderContextValues コンテキストフラグが Flags パラメーターに設定されていない場合は NULL に設定します。

式に OR 演算子または AND 演算子を含めてはなりません。

式の属性名の後にスペースを付けてはなりません。

[in] Flags

レンダリングするイベントの情報を識別するフラグ。たとえば、システム情報、ユーザー情報、または特定の値などです。使用できる値については、 EVT_RENDER_CONTEXT_FLAGS 列挙を参照してください。

イベントの内容をレンダリングするために EvtRender 関数を呼び出すときに使用するコンテキストハンドル。それ以外の場合は NULL。 NULL の場合は、GetLastError 関数を呼び出してエラーコードを取得します。

イベントから指定した情報をレンダリングするには、 EvtRender 関数を呼び出します。

完了したら、 EvtClose 関数を呼び出してハンドルを閉じる必要があります。

この関数の使用方法を示す例については、「レンダリングイベント」を参照してください。