Classe TraceLoggingThreadActivity (traceloggingactivity.h)
Prend en charge la journalisation des événements ETW pendant une activité. Les événements seront automatiquement marqués avec ou imbriqués dans cette activité.
Héritage
La classe TraceLoggingThreadActivity implémente _TlgActivityBase.
Méthodes
La classe TraceLoggingThreadActivity a ces méthodes.
| TraceLoggingThreadActivity ::P rovider TraceLoggingThreadActivity ::P rovider (traceloggingactivity.h) retourne le handle au fournisseur TraceLogging associé à cette activité. |
| TraceLoggingThreadActivity ::TraceLoggingThreadActivity Initialise une nouvelle instance de la classe TraceLoggingThreadActivity. (surcharge 2/2) |
| TraceLoggingThreadActivity ::TraceLoggingThreadActivity Initialise une nouvelle instance de la classe TraceLoggingThreadActivity. (surcharge 1/2) |
Remarques
Cette classe fonctionne en définissant une variable par thread. Seuls les événements qui se produisent sur le thread actif sont automatiquement marqués.
Pour utiliser les activités TraceLogging, vous devez définir une instance de TraceLoggingActivity ou TraceLoggingThreadActivity. Après avoir créé une instance de l’une de ces classes, vous manipulez la journalisation d’activité à l’aide de l’instance de l’une de ces classes, vous manipulez la journalisation d’activité à l’aide de TraceLoggingFunction, TraceLoggingWriteStart, TraceLoggingWriteStop et TraceLoggingWriteTagged. Cette classe crée automatiquement un identificateur unique lorsque le suivi est activé et que l’activité est démarrée.
Tous les threads actifs sont automatiquement imbriqués dans cette instance lorsque vous commencez la journalisation avec un objet TraceLoggingThreadActivity. En outre, tous les événements sont automatiquement enregistrés avec l’identificateur unique de cet objet.
Important
Utilisez cette classe uniquement lorsque vous pouvez garantir que toutes les activités de ce thread sont entièrement imbriquées. Vous devez vous assurer qu’aucune activité enfant ne survivra à une activité parente, même dans les cas d’erreur ou de périphérie.
Notes
Dans les builds DEBUG, la classe déclenche une assertion pendant son événement Stop, si elle détecte un imbrication d’activité incorrecte ou si l’événement Stop se produit sur un thread autre que le thread utilisé pour le démarrer.
Cette classe n’est pas disponible pour les applications du store.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | traceloggingactivity.h |