Funzione EvtNext (winevt.h)

Articolo
08/27/2023

Ottiene l'evento successivo dai risultati della query o della sottoscrizione.

Sintassi

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

Parametri

[in] ResultSet

Handle per un set di risultati di query o sottoscrizione restituito dalla funzione EvtQuery o dalla funzione EvtSubscribe .

[in] EventsSize

Numero di elementi nella matrice EventArray . La funzione tenterà di recuperare questo numero di elementi dal set di risultati.

[in] Events

Puntatore a una matrice di handle che verranno impostati sugli handle sugli eventi del set di risultati.

[in] Timeout

Numero di millisecondi che si è disposti ad attendere un risultato. Impostare su INFINITE per indicare nessun valore di timeout. Se il timeout scade, l'ultimo errore viene impostato su ERROR_TIMEOUT.

[in] Flags

Riservato. Deve essere zero.

[out] Returned

Numero di handle nella matrice impostata.

Valore restituito

Codice/valore restituito	Descrizione
TRUE	Funzione completata.
FALSE	La funzione non è riuscita. Per ottenere il codice di errore, chiamare la funzione GetLastError .

Commenti

Chiamare questa funzione in un ciclo fino a quando la funzione restituisce FALSE e il codice di errore è ERROR_NO_MORE_ITEMS.

Per ogni evento recuperato, è quindi possibile chiamare le funzioni EvtCreateRenderContext e EvtRender per eseguire il rendering dell'evento.

È necessario chiamare EvtClose in ogni handle di evento ricevuto.

Esempio

Per un esempio che illustra come usare questa funzione, vedere Query per eventi e sottoscrizione agli eventi.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winevt.h
Libreria	Wevtapi.lib
DLL	Wevtapi.dll

Vedi anche

EvtQuery

EvtSeek

EvtSubscribe

Condividi tramite