ATLTRACE2
Relata avisos para um dispositivo de saída, como a janela do depurador, de acordo com os sinalizadores e níveis indicados.
ATLTRACE2( exp ); ATLTRACE2( DWORD category, UINT level, LPCSTR lpszFormat, ... );
Parâmetros
exp
[in] a cadeia de caracteres para enviar para a janela de saída do Visual C++ ou qualquer aplicativo que interceptar essas mensagens.category
[in] tipo de evento ou de método no qual a relatar.Consulte os comentários para obter uma lista de categorias.level
[in] o nível de rastreamento para relatar.Consulte os comentários para obter detalhes.lpszFormat
[in] printf- estilize a cadeia de caracteres de formato para usar o para criar uma cadeia de caracteres para enviar para o dispositivo de despejo.
Comentários
A forma curta de ATLTRACE2 grava uma cadeia de caracteres para a janela de saída do depurador.O segundo formulário de ATLTRACE2 também gravar a saída na janela de saída do depurador, mas está sujeito às configurações da ferramenta de rastreamento de ATL/MFC (consulte Exemplo de ATLTraceTool).Por exemplo, se você level definido como 4 e a ferramenta de rastreamento de ATL/MFC o nível 0, você não verá a mensagem.o nível pode ser 0, 1, 2, 3, 4 ou.A opção, 0, relata somente aos problemas graves.
Listas de parâmetros de category os sinalizadores de rastreamento para definir.Esses sinalizadores correspondem aos tipos de métodos que você deseja informar.As tabelas a lista nos sinalizadores de rastreamento válidos você pode usar para o parâmetro de category .
Sinalizadores de rastreamento de ATL
Categoria de ATL |
Descrição |
|---|---|
atlTraceGeneral |
Relatórios em todos os aplicativos de ATL.A opção. |
atlTraceCOM |
Relatórios em métodos COM. |
atlTraceQI |
Relatórios em chamadas de QueryInterface. |
atlTraceRegistrar |
Relatórios no registro de objetos. |
atlTraceRefcount |
Relatórios em alterar a contagem de referência. |
atlTraceWindowing |
Relatórios em métodos do windows; por exemplo, relatórios uma identificação inválido do mapa de mensagem |
atlTraceControls |
Relatórios em controles; por exemplo, relatórios quando um controle ou sua janela são destruídos. |
atlTraceHosting |
Relatórios que hospedam mensagens; por exemplo, relatórios quando um cliente em um contêiner está ativado. |
atlTraceDBClient |
Relatórios no modelo do consumidor do OLE DB; por exemplo, quando uma chamada a GetData falhar, a saída podem conter o HRESULT. |
atlTraceDBProvider |
Relatórios no modelo de provedor do OLE DB; por exemplo, relatórios se a criação de uma coluna falhou. |
atlTraceSnapin |
Relatórios para SnapIn do aplicativo ASP.NET. |
atlTraceNotImpl |
Relata que a função indicada não está implementado. |
atlTraceAllocation |
Reporta as mensagens impressas por ferramentas de depuração de memória em atldbgmem.h. |
Sinalizadores de rastreamento MFC
Categoria MFC |
Descrição |
|---|---|
traceAppMsg |
Uso geral, mensagens MFC.Sempre recomendável. |
traceDumpContext |
Mensagens de CDumpContext. |
traceWinMsg |
Mensagens de código de tratamento de mensagens MFC. |
traceMemory |
Mensagens de código de gerenciamento de memória MFC. |
traceCmdRouting |
Mensagens de código de roteamento de comando do Windows MFC. |
traceHtml |
Mensagens de suporte da caixa de diálogo de DHTML MFC. |
traceSocket |
Mensagens de suporte de soquete MFC. |
traceOle |
Mensagens de suporte OLE MFC. |
traceDatabase |
Mensagens de suporte a banco de dados MFC. |
traceInternet |
Mensagens de suporte da Internet MFC. |
Para declarar uma categoria de rastreamento personalizada, declare uma instância global da classe de CTraceCategory como segue:
CTraceCategory MY_CATEGORY(_T("MyCategoryName"), 1);
O nome de categoria, MY_CATEGORY nesse exemplo, é o nome que você especificar a category o parâmetro.O primeiro parâmetro é o nome da categoria que aparecerá na ferramenta de rastreamento de ATL/MFC.O segundo parâmetro é o nível de rastreamento padrão.Esse 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, definições de inserção para esses macros em Stdafx.h antes da instrução de #include <atlbase.h> .
Como alternativa, você pode definir o filtro sobre diretivas pré-processamento na caixa de diálogo de Páginas de Propriedade .Clique na guia de Pré-Processador e inserção no global na caixa de edição de Definições do Pré-processador pré-processamento.
Atlbase.h contém definições padrão de macros de ATLTRACE2 e essas definições serão usadas se você não definir esses símbolos antes que atlbase.h é processado.
Em construções de versão, ATLTRACE2 compila o (void) 0.
ATLTRACE2 limita o conteúdo cadeia de caracteres a ser enviada para o dispositivo de despejo a não mais de 1023 caracteres, após a formatação.
ATLTRACE e ATLTRACE2 tem o mesmo comportamento, ATLTRACE são incluídos 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