Compartilhar via


Interface ITracer (wdtf.h)

A interface ITracer permite que instâncias individuais de cada interface WDTF determinem as configurações de rastreamento específicas para uma determinada coclass de implementação. Essas configurações são registradas no registro.

Herança

A interface ITracer herda da interface IDispatch . O ITracer também tem esses tipos de membros:

  • Métodos

Métodos

A interface ITracer tem esses métodos.

 
ITracer::GetBits

O método GetBits retorna o conjunto de sinalizadores de rastreamento para uma coclasse como uma máscara de bits, dado um valor TTraceLevel especificado e o CLSID da coclass.

Comentários

Normalmente, você nunca verá a interface ITracer . Na verdade, mesmo que você esteja criando plug-ins de ação do WDTF, provavelmente não precisará usar essa interface. O ITracer é implementado em WDTF.dll e fornece as definições globais para as configurações específicas associadas a cada valor de enumeração TTraceLevel .

A tabela a seguir descreve os sinalizadores internos para rastreamento do WDTF. Os níveis individuais dentro da enumeração TTraceLevel correspondem a um conjunto de sinalizadores de rastreamento internos. A chave do Registro listada em TraceLevel Path (na seção Detalhes da Implementação a seguir) contém as máscaras de bits para cada TTraceLevel, como mostra a tabela a seguir.

Trace2_Medium contém todos os sinalizadores Trace1_Low e Trace3_High contém todos os sinalizadores Trace2_Medium.

Sinalizador de rastreamento Significado bit Nível de rastreamento padrão
COMEntryExit Um método OU propriedade COM para entrada e saída 0x0001 Trace1_Low
COMError Um erro foi encontrado por um método ou propriedade COM 0x0002 Trace1_Low
EntryExit Uma função C++ para entrada e saída 0x0004 Trace2_Medium
APICall Prestes a chamar uma API 0x0008 Trace2_Medium
Info Informações adicionais 0x0010 Trace2_Medium
Aviso Aviso de que algo pode estar errado 0x0020 Trace1_Low
Erro Um erro foi encontrado no WDTF 0x0040 Trace1_Low
NoisyCOMEntryExit A versão barulhenta do sinalizador COMError 0x0080 Trace3_High
NoisyEntryExit A versão barulhenta do sinalizador EntryExit 0x0100 Trace3_High
NoisyAPICall A versão barulhenta do sinalizador APICall 0x0200 Trace3_High
NoisyInfo A versão barulhenta do sinalizador Info 0x0400 Trace3_High
NoisyWarning A versão barulhenta do sinalizador aviso 0x0800 Trace3_High
 

Detalhes da implementação

ProgID: WDTF. Tracer

Caminho TraceLevel: HKCR\WDTF. Tracer.1\

Nota A implementação da interface ITracer é thread-safe.
 

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho wdtf.h

Confira também

ITracing

TTraceLevel