EvtNextEventMetadata function (winevt.h)

Article
10/13/2021

Gets an event definition from the enumerator.

Syntax

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

Parameters

[in] EventMetadataEnum

A handle to the event definition enumerator that the EvtOpenEventMetadataEnum function returns.

[in] Flags

Reserved. Must be zero.

Return value

If successful, the function returns a handle to the event's metadata; otherwise, NULL. If NULL, call GetLastError function to get the error code.

Remarks

Call this function in a loop until the function returns NULL and the error code is ERROR_NO_MORE_ITEMS.

To get a property from the event definition, call the EvtGetEventMetadataProperty function.

You must call the EvtClose function to close the event definition handle when done.

Examples

For an example that shows how to use this function, see Getting a Provider's Metadata.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	winevt.h
Library	Wevtapi.lib
DLL	Wevtapi.dll