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 函数以关闭句柄。

示例

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

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 winevt.h
Library Wevtapi.lib
DLL Wevtapi.dll

另请参阅

EvtRender