EvtNextEventMetadata-Funktion (winevt.h)

Ruft eine Ereignisdefinition aus dem Enumerator ab.

Syntax

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

Parameter

[in] EventMetadataEnum

Ein Handle für den Ereignisdefinitions-Enumerator, den die EvtOpenEventMetadataEnum-Funktion zurückgibt.

[in] Flags

Reserviert. Muss Null sein.

Rückgabewert

Bei erfolgreicher Ausführung gibt die Funktion ein Handle für die Metadaten des Ereignisses zurück. andernfalls NULL. Wenn NULL, rufen Sie die GetLastError-Funktion auf, um den Fehlercode abzurufen.

Hinweise

Rufen Sie diese Funktion in einer Schleife auf, bis die Funktion NULL zurückgibt und der Fehlercode ERROR_NO_MORE_ITEMS wird.

Um eine Eigenschaft aus der Ereignisdefinition abzurufen, rufen Sie die EvtGetEventMetadataProperty-Funktion auf.

Sie müssen die EvtClose-Funktion aufrufen, um das Ereignisdefinitionshandle zu schließen.

Beispiele

Ein Beispiel für die Verwendung dieser Funktion finden Sie unter Abrufen der Metadaten eines Anbieters.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winevt.h
Bibliothek Wevtapi.lib
DLL Wevtapi.dll

Weitere Informationen

EvtGetEventMetadataProperty