EvtCreateRenderContext, fonction (winevt.h)
Crée un contexte qui spécifie les informations dans l’événement que vous souhaitez afficher.
Syntaxe
EVT_HANDLE EvtCreateRenderContext(
[in] DWORD ValuePathsCount,
[in] LPCWSTR *ValuePaths,
[in] DWORD Flags
);
Paramètres
[in] ValuePathsCount
Nombre d’expressions XPath dans le paramètre ValuePaths .
[in] ValuePaths
Tableau d’expressions XPath qui identifient de façon unique un nœud ou un attribut dans l’événement que vous souhaitez afficher.
Affectez la valeur NULL si l’indicateur de contexte EvtRenderContextValues n’est pas défini dans le paramètre Flags .
Les expressions ne doivent pas contenir l’opérateur OR ou AND .
Les noms d’attributs dans les expressions ne doivent pas être suivis d’un espace.
[in] Flags
Indicateur qui identifie les informations dans l’événement que vous souhaitez afficher. Par exemple, les informations système, les informations utilisateur ou des valeurs spécifiques. Pour connaître les valeurs possibles, consultez l’énumération EVT_RENDER_CONTEXT_FLAGS .
Valeur retournée
Handle de contexte que vous utilisez lors de l’appel de la fonction EvtRender pour afficher le contenu d’un événement ; sinon, NULL. Si la valeur est NULL, appelez la fonction GetLastError pour obtenir le code d’erreur.
Remarques
Pour afficher les informations spécifiées à partir de l’événement, appelez la fonction EvtRender .
Vous devez appeler la fonction EvtClose pour fermer le handle lorsque vous avez terminé.
Exemples
Pour obtenir un exemple montrant comment utiliser cette fonction, consultez Événements de rendu.
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 |