evtGetEventInfo 函数 (winevt.h)

获取标识所选事件的结构化 XML 查询以及包含事件的通道或日志文件的信息。

语法

BOOL EvtGetEventInfo(
  [in]  EVT_HANDLE            Event,
  [in]  EVT_EVENT_PROPERTY_ID PropertyId,
  [in]  DWORD                 PropertyValueBufferSize,
  [in]  PEVT_VARIANT          PropertyValueBuffer,
  [out] PDWORD                PropertyValueBufferUsed
);

参数

[in] Event

要检索其信息的事件的句柄。

[in] PropertyId

标识要检索的信息的标志。 例如，查询标识符或路径。 有关可能的值，请参阅 EVT_EVENT_PROPERTY_ID 枚举。

[in] PropertyValueBufferSize

PropertyValueBuffer 缓冲区的大小（以字节为单位）。

[in] PropertyValueBuffer

将接收信息的调用方分配的缓冲区。 缓冲区包含 EVT_VARIANT 对象。 可以将此参数设置为 NULL ，以确定所需的缓冲区大小。

[out] PropertyValueBufferUsed

函数使用的调用方分配的缓冲区的大小（以字节为单位），如果函数失败并出现ERROR_INSUFFICIENT_BUFFER，则为所需的缓冲区大小。

返回值

返回代码/值	说明
TRUE	函数成功。
FALSE	函数失败。 使用 GetLastError 函数获取错误代码。

注解

如果传递给 EvtQuery 或 EvtSubscribe 的 查询是 XPath 而不是结构化 XML 查询，则查询标识符将为零，路径将是传递给函数的路径。

要求

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