Share via


Classe TraceLoggingThreadActivity (traceloggingactivity.h)

Fornisce supporto per la registrazione di eventi ETW durante un'attività. Gli eventi verranno contrassegnati automaticamente con o annidati in questa attività.

Ereditarietà

La classe TraceLoggingThreadActivity implementa _TlgActivityBase.

Metodi

La classe TraceLoggingThreadActivity include questi metodi.

 
TraceLoggingThreadActivity::P rovider

TraceLoggingThreadActivity::P rovider (traceloggingactivity.h) restituisce l'handle al provider TraceLogging associato a questa attività.
TraceLoggingThreadActivity::TraceLoggingThreadActivity

Inizializza una nuova istanza della classe TraceLoggingThreadActivity. (overload 2/2)
TraceLoggingThreadActivity::TraceLoggingThreadActivity

Inizializza una nuova istanza della classe TraceLoggingThreadActivity. (overload 1/2)

Commenti

Questa classe funziona impostando una variabile per thread. Solo gli eventi che si verificano nel thread attivo verranno contrassegnati automaticamente.

Per usare le attività TraceLogging, è necessario definire un'istanza di TraceLoggingActivity o TraceLoggingThreadActivity. Dopo aver creato un'istanza di una di queste classi, è possibile modificare la registrazione delle attività usando Dopo aver creato un'istanza di una di queste classi, è possibile modificare la registrazione delle attività usando TraceLoggingFunction, TraceLoggingWriteStart, TraceLoggingWriteStop e TraceLoggingWriteTagged. Questa classe crea automaticamente un identificatore univoco quando viene attivata la traccia e l'attività viene avviata.

Tutti i thread attivi verranno annidati automaticamente in questa istanza quando si inizia la registrazione con un oggetto TraceLoggingThreadActivity . Inoltre, tutti gli eventi verranno registrati automaticamente con l'identificatore univoco di questo oggetto.

Importante

Usare questa classe solo quando è possibile garantire che tutte le attività per questo thread siano completamente annidate. È necessario assicurarsi che nessuna attività figlio avrà esito negativo per un'attività padre, anche in casi di errore o casi limite.

Nota

Nelle compilazioni DEBUG la classe genererà un'asserzione durante l'evento Stop, se rileva un annidamento di attività non corretto o se l'evento Stop si verifica in un thread diverso dal thread usato per avviarlo.

Questa classe non è disponibile per le applicazioni di archiviazione.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione traceloggingactivity.h

Vedi anche

Classe TraceLoggingActivity