ATLTRACE2

Reporta avisos para um dispositivo de saída, sistema autônomo a janela do depurador, de acordo com aos sinalizadores indicados e níveis.

ATLTRACE2( exp );
ATLTRACE2(
   DWORD category,
   UINT level,
   LPCSTR lpszFormat,
   ...
);

Parâmetros

  • exp
    [in] A seqüência de caracteres e variáveis para enviar para a janela de saída do Visual C++ ou qualquer aplicativo que intercepta essas mensagens.

  • category
    [in] Tipo de evento ou método no qual ao relatório.Consulte comentários para obter uma lista de categorias.

  • level
    [in] O nível de rastreamento para o relatório.Consulte comentários para obter detalhes.

  • lpszFormat
    [in] A seqüência formatada para enviar para o dispositivo de despejo.

Comentários

Forma abreviada de ATLTRACE2 janela de saída do grava saída para o depurador. A segunda forma de ATLTRACE2 também grava a saída para janela de saída o depurador na, mas está sujeita às configurações da ferramenta de rastreamento ATL/MFC (consulte Exemplo de ATLTraceTool).Por exemplo, se você conjunto level 4 e a ferramenta de rastreamento ATL/MFC para nível 0, você não verá a mensagem. nível pode ser 0, 1, 2, 3 ou 4.O padrão, 0, relata somente os problemas mais graves.

The category parâmetro de lista de sinalizadores de rastreamento para conjunto. Esses sinalizadores correspondem aos tipos de métodos para o qual você deseja reportar.As tabelas abaixo listam os sinalizadores de rastreamento válido para poder usar o category parâmetro.

Sinalizadores de rastreamento do ATL

Categoria do ATL

Descrição

atlTraceGeneral

Relatórios em todos os aplicativos da ATL.O padrão.

atlTraceCOM

Relatórios sobre métodos COM.

atlTraceQI

Relatórios em chamadas de QueryInterface.

atlTraceRegistrar

Relatórios sobre o inscrição de objetos.

atlTraceRefcount

Relatórios sobre a alteração da contagem de referência.

atlTraceWindowing

Relatórios sobre métodos de janelas; por exemplo, relata uma ID de MAP de mensagem inválido.

atlTraceControls

Relatórios sobre controles; por exemplo, relata quando um controle ou janela é destruída.

atlTraceHosting

Relatórios de hospedagem de mensagens; por exemplo, relata quando um cliente em um contêiner é ativado.

atlTraceDBClient

Relatórios sobre o OLE DB consumidor modelo; por exemplo, quando uma telefonar com GetData falhar, a saída pode conter o HRESULT.

atlTraceDBProvider

Relatórios sobre o OLE DB provedor modelo; por exemplo, relata se falha na criação de uma coluna.

atlTraceSnapin

Relatórios de aplicativos de snap-in do MMC.

atlTraceNotImpl

Relata que a função indicada não está implementada.

atlTraceAllocation

Mensagens de relatórios impressas por memória ferramentas em atldbgmem.h de depuração.

Sinalizadores de rastreamento do MFC

Categoria do MFC

Descrição

traceAppMsg

Uso geral, as mensagens do MFC.Sempre recomendável.

traceDumpContext

Mensagens de CDumpContext.

traceWinMsg

Mensagens da mensagem do MFC código de tratamento.

traceMemory

Mensagens de código de gerenciamento de memória do MFC.

traceCmdRouting

Mensagens do Windows do MFC roteamento código de comando.

traceHtml

Mensagens de suporte a caixa de diálogo do MFC DHTML.

traceSocket

Mensagens de suporte do soquete do MFC.

traceOle

Mensagens de suporte a OLE do MFC.

traceDatabase

Mensagens de suporte a banco de dados do MFC.

traceInternet

Suportam a mensagens da Internet do MFC.

Para declarar uma categoria de rastreamento personalizadas, declare uma instância global do CTraceCategory classe da seguinte maneira:

CTraceCategory MY_CATEGORY(_T("MyCategoryName"), 1);

O nome da categoria, MY_CATEGORY Neste exemplo, é o nome especificado para o category parâmetro. O primeiro parâmetro é o nome da categoria que será exibida a ferramenta de rastreamento ATL/MFC.O segundo parâmetro é o nível de rastreamento padrão.Este parâmetro é opcional e o nível de rastreamento padrão é 0.

Para usar uma categoria definida pelo usuário:

ATLTRACE2(MY_CATEGORY, 2, _T("a message in a custom category"));

Para especificar que você deseja filtrar as mensagens de rastreamento, insira as definições para essas macros stdafx.h antes do #include <atlbase.h> demonstrativo.

Como alternativa, você pode conjunto o filtro nas diretivas de pré-processador no Páginas de propriedades caixa de diálogo.clicar no Pré-processador guia e em seguida, insira o modelo global para o Definições de pré-processador caixa de edição.

Atlbase.h contém definições padrão do ATLTRACE2 as macros e essas definições serão usadas se você não definir esses símbolos antes atlbase.h seja processado.

Nas compilações lançadas, ATLTRACE2 compila para (void) 0.

ATLTRACE2 limita o Sumário seqüência de caracteres a ser enviada para o dispositivo de despejo não mais de 1023 caracteres, após a formatação.

ATLTRACE and ATLTRACE2 ter o mesmo comportamento ATLTRACE é incluído para compatibilidade com versões anteriores.

Exemplo

int i = 1;
ATLTRACE2(atlTraceGeneral, 4, "Integer = %d\n", i);
// Output: 'Integer = 1'

Requisitos

Cabeçalho: atltrace.h

Consulte também

Referência

ATLTRACE (ATL)

Outros recursos

Depuração e erro Reporting Macros