Share via


Classe TraceLoggingThreadActivity (traceloggingactivity.h)

Fornece suporte para registro em log de eventos ETW durante uma atividade. Os eventos serão marcados automaticamente com ou aninhados nessa atividade.

Herança

A classe TraceLoggingThreadActivity implementa _TlgActivityBase.

Métodos

A classe TraceLoggingThreadActivity tem esses métodos.

 
TraceLoggingThreadActivity::P rovider

TraceLoggingThreadActivity::P rovider (traceloggingactivity.h) retorna o identificador para o provedor TraceLogging associado a essa atividade.
TraceLoggingThreadActivity::TraceLoggingThreadActivity

Inicializa uma nova instância da classe TraceLoggingThreadActivity. (sobrecarga 2/2)
TraceLoggingThreadActivity::TraceLoggingThreadActivity

Inicializa uma nova instância da classe TraceLoggingThreadActivity. (sobrecarga 1/2)

Comentários

Essa classe funciona definindo uma variável por thread. Somente os eventos que ocorrem no thread ativo serão marcados automaticamente.

Para usar atividades de TraceLogging, você precisa definir uma instância de TraceLoggingActivity ou TraceLoggingThreadActivity. Depois de criar uma instância de uma dessas classes, você manipula o log de atividades usando Depois de criar uma instância de uma dessas classes, você manipula o log de atividades usando TraceLoggingFunction, TraceLoggingWriteStart, TraceLoggingWriteStop e TraceLoggingWriteTagged. Essa classe cria automaticamente um identificador exclusivo quando o rastreamento é ativado e a atividade é iniciada.

Todos os threads ativos serão aninhados automaticamente nessa instância quando você iniciar o registro em log com um objeto TraceLoggingThreadActivity . Além disso, todos os eventos serão registrados automaticamente com o identificador exclusivo desse objeto.

Importante

Use essa classe somente quando puder garantir que todas as atividades desse thread estejam totalmente aninhadas. Você deve garantir que nenhuma atividade filho supere uma atividade pai, mesmo em casos de erro ou casos de borda.

Observação

Em builds DEBUG, a classe gerará uma asserção durante seu evento Stop, se detectar aninhamento de atividade incorreto ou se o evento Stop ocorrer em um thread diferente do thread usado para iniciá-lo.

Essa classe não está disponível para aplicativos de repositório.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho traceloggingactivity.h

Confira também

Classe TraceLoggingActivity