ATLTRACE2

Segnala gli avvisi in un dispositivo di output, ad esempio la finestra del debugger, come i flag e i livelli visualizzati.

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

Parametri

  • exp
    [in] la stringa per inviare Visual C++ nella finestra di output o a qualsiasi applicazione che intercetta i messaggi.

  • category
    [in] tipo di evento o del metodo in cui i rapporti.Vedere le note per un elenco di categorie.

  • level
    [in] il livello di analisi dei rapporti.Vedere le note per i dettagli.

  • lpszFormat
    [in] la stringa di formato stile di printfda utilizzare per creare una stringa da inviare al dispositivo di dump.

Note

La forma breve di ATLTRACE2 scrivere una stringa nella finestra di output del debugger.La seconda forma di ATLTRACE2 anche l'output viene scritto nella finestra di output del debugger, ma è soggetto alle impostazioni dello strumento di traccia ATL/MFC (vedere Esempio ATLTraceTool).Ad esempio, se level impostato su 4 e lo strumento di traccia ATL/MFC di Livello 0, non verrà visualizzato il messaggio.il livello può essere 0, 1, 2, 3, o 4.Per impostazione predefinita, 0, rapporti solo la maggior parte dei problemi gravi.

Gli elenchi di parametri di category i contrassegni di analisi da impostare.Questi flag corrispondono a tipi di metodi per il quale si desidera creare.Le tabelle l'elenco di seguito i contrassegni di analisi validi è possibile utilizzare per il parametro di category.

Flag di traccia ATL

Categoria ATL

Descrizione

atlTraceGeneral

Rapporti su tutte le applicazioni ATL.Valore predefinito.

atlTraceCOM

Rapporti sui metodi COM.

atlTraceQI

Rapporti sulle chiamate di QueryInterface.

atlTraceRegistrar

Rapporti sulla registrazione degli oggetti.

atlTraceRefcount

Rapporti per modificare conteggio dei riferimenti.

atlTraceWindowing

Rapporti sui metodi di Windows, ad esempio, rapporti un ID non valida della mappa messaggi

atlTraceControls

Rapporti sui controlli; ad esempio, rapporti quando un controllo o la finestra viene distrutta.

atlTraceHosting

Rapporti che ospitano i messaggi, ad esempio, rapporti quando un client in un contenitore è attivato.

atlTraceDBClient

Rapporti su modelli consumer OLE DB, ad esempio, quando una chiamata a GetData non riesce, l'output può contenere un HRESULT.

atlTraceDBProvider

Rapporti su modelli provider OLE DB, ad esempio, segnala la creazione di una colonna ha esito negativo.

atlTraceSnapin

Rapporti per l'applicazione SnapIn MMC.

atlTraceNotImpl

Rapporti che la funzione specificata non è implementata.

atlTraceAllocation

Segnalazione dei messaggi visualizzati dagli strumenti di debug di memoria in atldbgmem.h.

Flag di analisi MFC

Categoria MFC

Descrizione

traceAppMsg

Utilizzo generale, messaggi MFC.Utilizzare sempre.

traceDumpContext

Messaggi da CDumpContext.

traceWinMsg

Messaggi dal codice di gestione dei messaggi di MFC.

traceMemory

Messaggi dal codice di gestione della memoria di MFC.

traceCmdRouting

Messaggi dal codice di routing dei comandi di Windows di MFC.

traceHtml

Messaggi dal supporto della finestra di dialogo DHTML di MFC.

traceSocket

Messaggi dal supporto di socket di MFC.

traceOle

Messaggi dal supporto di OLE di MFC.

traceDatabase

Messaggi dal supporto di database MFC.

traceInternet

Messaggi dal supporto Internet di MFC.

Per dichiarare una categoria di traccia personalizzata, dichiarare un'istanza globale della classe di CTraceCategory come segue:

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

Il nome della categoria, MY_CATEGORY in questo esempio, il nome specificato a category il parametro.Il primo parametro è il nome della categoria visualizzato lo strumento di traccia ATL/MFC.Il secondo parametro è il livello di traccia predefinito.Questo parametro è facoltativo e il livello di traccia predefinito è 0.

Per utilizzare una categoria utente:

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

Per specificare che si desidera filtrare messaggi di traccia, definizioni di inserimento per queste macro in Stdafx.h prima dell'istruzione di #include <atlbase.h>.

In alternativa, è possibile impostare il filtro nelle direttive per il preprocessore nella finestra di dialogo Pagine delle proprietà.Fare clic sulla scheda PREPROCESSORE quindi inserire il globale nella casella di modifica Definizioni preprocessore.

Atlbase.h contiene le definizioni predefinite delle macro di ATLTRACE2 e queste definizioni verranno utilizzate se non si definisce i simboli atlbase.h prima che venga elaborata.

Nelle build di rilascio, ATLTRACE2 viene compilato in (void) 0.

ATLTRACE2 limita il contenuto della stringa da inviare al dispositivo di dump a non più di 1023 caratteri, dopo la formattazione.

ATLTRACE e ATLTRACE2 presentano lo stesso comportamento, è ATLTRACE importati per compatibilità con le versioni precedenti.

Esempio

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

Requisiti

Header: atltrace.h

Vedere anche

Riferimenti

ATLTRACE (ATL)

Altre risorse

Macro di segnalazione errori e il debug