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