evtNextEventMetadata 函数 (winevt.h)

从枚举器获取事件定义。

语法

EVT_HANDLE EvtNextEventMetadata(
  [in] EVT_HANDLE EventMetadataEnum,
  [in] DWORD      Flags
);

参数

[in] EventMetadataEnum

EvtOpenEventMetadataEnum 函数返回的事件定义枚举器的句柄。

[in] Flags

保留。 必须为零。

返回值

如果成功,函数将返回事件元数据的句柄;否则为 NULL。 如果 为 NULL,则调用 GetLastError 函数以获取错误代码。

注解

在循环中调用此函数,直到函数返回 NULL 并且错误代码ERROR_NO_MORE_ITEMS。

若要从事件定义获取属性,请调用 EvtGetEventMetadataProperty 函数。

完成后,必须调用 EvtClose 函数以关闭事件定义句柄。

示例

有关演示如何使用此函数的示例,请参阅 获取提供程序的元数据

要求

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

另请参阅

EvtGetEventMetadataProperty