evtCreateRenderContext 函数 (winevt.h)

创建一个上下文，该上下文指定要呈现的事件中的信息。

语法

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

[in] ValuePathsCount

ValuePaths 参数中的 XPath 表达式数。

[in] ValuePaths

XPath 表达式的数组，在要呈现的事件中唯一标识节点或属性。

如果未在 Flags 参数中设置 EvtRenderContextValues 上下文标志，则设置为 NULL。

表达式不得包含 OR 或 AND 运算符。

表达式中的属性名称不得后跟空格。

[in] Flags

标识要呈现的事件中的信息的标志。例如，系统信息、用户信息或特定值。有关可能的值，请参阅 EVT_RENDER_CONTEXT_FLAGS 枚举。

调用 EvtRender 函数来呈现事件内容时使用的上下文句柄;否则为 NULL。如果 为 NULL，则调用 GetLastError 函数以获取错误代码。

若要呈现事件中的指定信息，请调用 EvtRender 函数。

完成后，必须调用 EvtClose 函数以关闭句柄。

有关演示如何使用此函数的示例，请参阅呈现事件。