EvtNext-Funktion (winevt.h)
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 |
|---|---|
|
Die Funktion wurde erfolgreich ausgeführt. |
|
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 |