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