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

Voir aussi

EvtRender