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 |