EvtCreateBookmark, fonction (winevt.h)

Crée un signet qui identifie un événement dans un canal.

Syntaxe

EVT_HANDLE EvtCreateBookmark(
  [in, optional] LPCWSTR BookmarkXml
);

Paramètres

[in, optional] BookmarkXml

Chaîne XML qui contient le signet ou NULL en cas de création d’un signet.

Valeur retournée

Handle du signet si l’appel réussit ; sinon, NULL. Si la valeur est NULL, appelez la fonction GetLastError pour obtenir le code d’erreur.

Remarques

Pour créer un signet, définissez le paramètre BookmarkXml sur NULL. Avant de quitter, appelez la fonction EvtUpdateBookmark pour mettre à jour le signet. Passez le handle de signet à la fonction EvtRender pour afficher le signet sous la forme d’une chaîne XML. Vous pouvez ensuite conserver la chaîne pour une utilisation ultérieure. Pour commencer à consommer des événements à partir de l’endroit où vous vous êtes arrêté la dernière fois, définissez BookmarkXml sur la chaîne XML que vous avez conservée. Pour un abonnement, passez le handle de signet à la fonction EvtSubscribe . Pour une requête, passez le handle de signet à la fonction EvtSeek pour rechercher un événement spécifique dans le résultat de la requête.

Si la requête concerne plusieurs canaux, le handle de signet contiendra des signets pour chaque canal. Vous ne pouvez pas créer de signet pour un fichier journal.

Vous devez appeler la fonction EvtClose pour fermer le handle lorsque vous avez terminé.

Exemples

Pour obtenir un exemple qui montre 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

EvtUpdateBookmark