ATLTRACE2 (DWORD categoria, UINT livello, LPCSTR lpszFormat,...)
Parametri
categoria
[in] AtlTraceFlags per indicare il tipo di evento o un metodo in cui alla relazione. Vedere la sezione Osservazioni per un elenco delle categorie.
livello
[in] Il livello di traccia alla relazione. Deve essere minore o uguale al valore impostato per ATL_TRACE_LEVEL ad apparire. Ad esempio, se si imposta il livello 4 e ATL_TRACE_LEVEL a 0, non si vedrà nessun avvertimenti. Vedere la sezione Osservazioni per ulteriori informazioni su ATL_TRACE_LEVEL.
lpszFormat
[in] La stringa formattata per inviare al dispositivo di dump.
Osservazioni
Utilizzare ATLTRACE2 per il debug. ATLTRACE2 for&nisce messaggi su come happen.nbsp eventi e metodi; ATLTRACE2 riporta avvisi e gli errori che si verificano come si esegue il debug del programma. ATLTRACE2 invia una stringa formattata, lpszFormat, di un dispositivo di dump, solitamente nella finestra di output debugger o in un file.
Il primo parametro per ATLTRACE2, categoria, elenca per impostare il flag di traccia. Questi flag corrispondono ai tipi di metodi di cui desidera relazione. La tabella seguente elenca i flag di traccia valido, che è possibile utilizzare per il parametro di categoria.
| Categoria | Descrizione |
| atlTraceUser | Definito dall'applicazione. Il valore indica il livello degli avvisi alla relazione di. |
| atlTraceGeneral | Relazioni su tutte le applicazioni ATL. Il valore predefinito. |
| atlTraceCOM | Relazioni sui metodi COM. |
| atlTraceQI | Rapporti sulle chiamate QueryInterface. |
| atlTraceRegistrar | Relazioni per la registrazione degli oggetti. |
| atlTraceRefcount | Rapporti su come cambiare il conteggio dei riferimenti. |
| atlTraceWindowing | Relazioni sui metodi di windows, ad esempio segnala un messaggio non valido mappa ID. |
| atlTraceControls | Segnala su controlli, ad esempio segnala quando è distrutto un controllo o la finestra di. |
| atlTraceHosting | Rapporti di hosting messaggi, ad esempio, quando un client in un contenitore viene attivato. |
| atlTraceDBClient | Relazioni sul modello di OLE DB dei consumatori; ad esempio quando una chiamata a GetData non riesce, l'output può contenere l' HRESULT. |
| atlTraceDBProvider | Segnala sul modello di Provider OLE DB, ad esempio segnala se la creazione di una colonna non è riuscita. |
| atlTraceSnapin | Relazioni per l'applicazione di snap-in MMC. |
| atlTraceNotImpl | Segnala che la funzione indicata non è implementata. |
Esempio
/ / esempio per ATLTRACE2
int i = 1;
ATLTRACE2 (atlTraceGeneral, 4, "Integer = %d\n", mi);
/ / Output: ' Integer = 1'
È possibile filtrare per specifiche categorie e livelli a livello di progetto impostando le due funzioni globali descritte di seguito. Per specificare tale filtro nelle definizioni per il preprocessore, inserire le funzioni globali in stdafx prima del #include lt;atlbase.h> istruzione.
In alternativa, è possibile impostare il filtro nelle direttive per il preprocessore nella finestra di dialogoimpostazioni progetto. Fare clic sulla scheda C/C++ e quindi inserire il globale nella casella di modifica definizioni per il preprocessore .
Per impostare le categorie e livelli, utilizzare le seguenti funzioni globali:
ATL_TRACE_CATEGORY 0XFFFFFFFF
Imposta la categoria di traccia per cui filtrare. Il valore predefinito, 0xFFFFFFFF riporta tutte le categorie. Per filtrare per una categoria specifica o un set di categorie, sostituire 0xFFFFFFFF con i nomi di categoria che si desidera analizzare. È possibile utilizzare OR bit per bit (|) operatore per filtrare per più di una categoria. Ad esempio, impostando ATL_TRACE_CATEGORY (atlTraceControls | atlTraceWindowing), si vedrà solo ATLTRACE2 gli avvisi per i controlli e le finestre.
ATL_TRACE_LEVEL 0
Imposta il livello di traccia per cui filtrare. Può essere 0, 1, 2, 3 o 4. Il valore predefinito, 0, riporta solo i problemi più gravi. Sostituire 0 con il livello di segnalazione che vuoi vedere. Ad esempio, specificando 4, potrai vedere tutti i livelli di avvisi e messaggi informativi.
Vedi anche