EvtOpenEventMetadataEnum function (winevt.h)

Gets a handle that you use to enumerate the list of events that the provider defines.

Syntax

EVT_HANDLE EvtOpenEventMetadataEnum(
  [in] EVT_HANDLE PublisherMetadata,
  [in] DWORD      Flags
);

Parameters

[in] PublisherMetadata

A handle to the provider's metadata that the EvtOpenPublisherMetadata function returns.

[in] Flags

Reserved. Must be zero.

Return value

If successful, the function returns a handle to the list of events that the provider defines; otherwise, NULL. If NULL, call GetLastError function to get the error code.

Remarks

To enumerate the events, call the EvtNextEventMetadata function in a loop.

You must call the EvtClose function to close the enumerator 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

See also

EvtGetEventMetadataProperty

EvtNextEventMetadata