EvtNext, fonction (winevt.h)

  • Article

Obtient l’événement suivant à partir des résultats de la requête ou de l’abonnement.

Syntaxe

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

Paramètres

[in] ResultSet

Handle d’un jeu de résultats de requête ou d’abonnement que la fonction EvtQuery ou la fonction EvtSubscribe retourne.

[in] EventsSize

Nombre d’éléments dans le tableau EventArray . La fonction essaiera de récupérer ce nombre d’éléments à partir du jeu de résultats.

[in] Events

Pointeur vers un tableau de handles qui sera défini sur les handles vers les événements du jeu de résultats.

[in] Timeout

Nombre de millisecondes que vous êtes prêt à attendre pour obtenir un résultat. Définissez sur INFINITE pour indiquer aucune valeur de délai d’attente. Si le délai d’expiration expire, la dernière erreur est définie sur ERROR_TIMEOUT.

[in] Flags

Réservé. Doit être zéro.

[out] Returned

Nombre de handles définis dans le tableau.

Valeur retournée

Code/valeur de retour Description
TRUE
 La fonction a réussi.
FALSE
 La fonction a échoué. Pour obtenir le code d’erreur, appelez la fonction GetLastError .

Remarques

Appelez cette fonction dans une boucle jusqu’à ce que la fonction retourne FALSE et que le code d’erreur soit ERROR_NO_MORE_ITEMS.

Pour chaque événement que vous récupérez, vous pouvez ensuite appeler les fonctions EvtCreateRenderContext et EvtRender pour afficher l’événement.

Vous devez appeler EvtClose sur chaque handle d’événement que vous recevez.

Exemples

Pour obtenir un exemple qui montre comment utiliser cette fonction, consultez Interrogation d’événements et Abonnement aux événements.

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winevt.h
Bibliothèque Wevtapi.lib
DLL Wevtapi.dll

Voir aussi

EvtQuery

EvtSeek

EvtSubscribe