ATLTRACE2 (DWORD categoria, UINT nível, LPCSTR lpszFormat,...)
Parâmetros
categoria
[no] O atlTraceFlags para indicar o tipo de evento ou método que ao relatório. Consulte "Comentários" para obter uma lista de categorias.
nível
[no] O nível de rastreamento ao relatório. Deve ser menor ou igual ao valor definido para ATL_TRACE_LEVEL a aparecer. Por exemplo, se você definir nível 4 e ATL_TRACE_LEVEL como 0, você verá sem avisos. Consulte comentários para obter mais informações sobre ATL_TRACE_LEVEL.
lpszFormat
[no] A Cadeia de caracteres formatada para enviar para o dispositivo de despejo.
Observações
Use ATLTRACE2 para fi&ns de depuração. ATLTRACE2 fornece mensagens sobre como happen.nbsp eventos e métodos; ATLTRACE2 relata avisos e erros que ocorrem quando você depura o programa. ATLTRACE2 envia uma Cadeia de caracteres formatada, lpszFormat, para um dispositivo de despejo, geralmente a janela de saída do depurador ou um arquivo.
O primeiro parâmetro para ATLTRACE2, categoria, lista os sinalizadores de rastreamento para definir. Esses sinalizadores correspondem aos tipos de métodos para o qual você deseja relatar. A tabela abaixo lista os sinalizadores de rastreamento válidos que você pode usar para o parâmetro de categoria.
| Categoria | Descrição |
| atlTraceUser | Definido pelo aplicativo. O valor indica o nível de avisos para relatório. |
| atlTraceGeneral | Relatórios sobre todos os aplicativos da ATL. O padrão. |
| atlTraceCOM | Relatórios sobre métodos COM. |
| atlTraceQI | Relatórios sobre chamadas de QueryInterface. |
| atlTraceRegistrar | Relatórios sobre o registro de objetos. |
| atlTraceRefcount | Relatórios sobre como alterar a contagem de referência. |
| atlTraceWindowing | Relatórios sobre os métodos de windows, por exemplo relata um ID de mapa de mensagem inválida. |
| atlTraceControls | Relatórios sobre controles, relatórios por exemplo quando um controle ou sua janela é destruída. |
| atlTraceHosting | Relatórios que hospeda mensagens, por exemplo, quando um cliente em um contêiner é ativado. |
| atlTraceDBClient | Relatórios sobre OLE DB consumidor modelo; por exemplo quando uma chamada GetData falhar, a saída pode conter o HRESULT. |
| atlTraceDBProvider | Relatórios sobre OLE DB Provedor modelo, por exemplo reporta se falha na criação de uma coluna. |
| atlTraceSnapin | Relatórios de aplicação de MMC snap-in. |
| atlTraceNotImpl | Relata que a função indicada não é implementada. |
Exemplo
/ / exemplo de ATLTRACE2
int i = 1;
ATLTRACE2 (atlTraceGeneral, 4, "Integer = %d\n", i);
/ / Saída: ' Integer = 1'
Você pode filtrar por níveis e categorias específicas no nível do projeto, definindo as duas funções globais descritas abaixo. Para especificar essa filtragem nas definições do pré-processador, inserir as funções globais em stdafx. h antes do #include lt;atlbase.h> instrução.
Como alternativa, você pode definir o filtro nas directivas de pré-processador na caixa de diálogoconfigurações do projeto. Clique na guia de C/C++ e, em seguida, insira o global na caixa de editar as definições de pré-processador .
Para definir as categorias e níveis, use o seguinte funções global:
ATL_TRACE_CATEGORY 0XFFFFFFFF
Define a Rastrear categoria para a qual deseja filtrar. O padrão, 0xFFFFFFFF relatórios de todas as categorias. Para filtrar uma categoria específica ou um conjunto de categorias, substitua 0xFFFFFFFF com os nomes das categorias que deseja rastrear. Você pode usar o bit a bit ou operador (|) para filtrar por mais de uma categoria. Por exemplo, definindo ATL_TRACE_CATEGORY (atlTraceControls | atlTraceWindowing), você verá somente os avisos de ATLTRACE2 para controles e janelas.
ATL_TRACE_LEVEL 0
Define o nível de rastreamento para o qual deseja filtrar. Pode ser 0, 1, 2, 3 ou 4. O padrão, 0, relata apenas os problemas mais graves. Substitua 0 com o nível de emissão de relatórios que deseja ver. Por exemplo, especificando 4, você verá todos os níveis de avisos e mensagens informativas.
Ver também