EvtSeek, fonction (winevt.h)

Article
03/04/2024

Recherche un événement spécifique dans un jeu de résultats de requête.

Syntaxe

BOOL EvtSeek(
  [in] EVT_HANDLE ResultSet,
  [in] LONGLONG   Position,
  [in] EVT_HANDLE Bookmark,
  [in] DWORD      Timeout,
  [in] DWORD      Flags
);

Paramètres

[in] ResultSet

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

[in] Position

Décalage de base zéro sur un événement dans le jeu de résultats. L’indicateur que vous spécifiez dans le paramètre Flags indique la position relative de début dans le jeu de résultats à partir de laquelle rechercher. Par exemple, vous pouvez rechercher à partir du début des résultats ou de la fin des résultats. Définissez sur 0 pour atteindre la position relative spécifiée par l’indicateur.

[in] Bookmark

Handle d’un signet que la fonction EvtCreateBookmark retourne. Le signet identifie un événement dans le jeu de résultats que vous souhaitez rechercher. Définissez ce paramètre uniquement si le paramètre Flags a l’indicateur EvtSeekRelativeToBookmark défini.

[in] Timeout

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

[in] Flags

Un ou plusieurs indicateurs qui indiquent la position relative dans le jeu de résultats à partir duquel rechercher. Pour connaître les valeurs possibles, consultez l’énumération EVT_SEEK_FLAGS .

Valeur retournée

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

Remarques

Vous pouvez utiliser cette fonction uniquement sur les jeux de résultats d’un canal Administration ou opérationnel, ou à partir de fichiers journaux .evtx.

Exemples

Pour obtenir un exemple montrant comment utiliser cette fonction, consultez Événements de signet.

Configuration requise

Condition requise	Valeur
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

EvtNext

EvtQuery

Partager via