EvtNext-Funktion (winevt.h)

  • Artikel

Ruft das nächste Ereignis aus den Abfrage- oder Abonnementergebnissen ab.

Syntax

BOOL EvtNext(
  [in]  EVT_HANDLE  ResultSet,
  [in]  DWORD       EventsSize,
  [in]  PEVT_HANDLE Events,
  [in]  DWORD       Timeout,
  [in]  DWORD       Flags,
  [out] PDWORD      Returned
);

Parameter

[in] ResultSet

Das Handle für ein Abfrage- oder Abonnement-Resultset, das von der EvtQuery-Funktion oder der EvtSubscribe-Funktion zurückgegeben wird.

[in] EventsSize

Die Anzahl der Elemente im EventArray-Array . Die Funktion versucht, diese Anzahl von Elementen aus dem Resultset abzurufen.

[in] Events

Ein Zeiger auf ein Array von Handles, das auf die Handles für die Ereignisse aus dem Resultset festgelegt wird.

[in] Timeout

Die Anzahl der Millisekunden, die Sie bereit sind, auf ein Ergebnis zu warten. Legen Sie diesen Wert auf INFINITE fest, um keinen Timeoutwert anzugeben. Wenn das Timeout abläuft, wird der letzte Fehler auf ERROR_TIMEOUT festgelegt.

[in] Flags

Reserviert. Muss Null sein.

[out] Returned

Die Anzahl der im Array festgelegten Handles.

Rückgabewert

Rückgabecode/-wert BESCHREIBUNG
TRUE
 Die Funktion wurde erfolgreich ausgeführt.
FALSE
 Fehler bei der Funktion. Rufen Sie die GetLastError-Funktion auf, um den Fehlercode abzurufen.

Hinweise

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

Für jedes Ereignis, das Sie abrufen, können Sie dann die Funktionen EvtCreateRenderContext und EvtRender aufrufen, um das Ereignis zu rendern.

Sie müssen EvtClose für jedes Ereignishandle aufrufen, das Sie erhalten.

Beispiele

Ein Beispiel für die Verwendung dieser Funktion finden Sie unter Abfragen von Ereignissen und Abonnieren von Ereignissen.

Anforderungen

   
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

EvtQuery

EvtSeek

EvtSubscribe