ATLTRACE2
Stocke des avertissements à un périphérique de sortie, telles que la fenêtre du débogueur, en fonction de les balises et les niveaux indiqués.
ATLTRACE2( exp );
ATLTRACE2(
DWORD category,
UINT level,
LPCSTR lpszFormat,
...
);
Paramètres
exp
[in] la chaîne à envoyer à la fenêtre Sortie de Visual C++ ou à une application qui intercepte les messages.category
[in] type de l'événement méthode ou sur lequel stocker.Consultez les notes d'une liste de catégories.level
[in] le niveau de traçage à enregistrer.Consultez les notes pour plus d'informations.lpszFormat
[in] la chaîne de format de style d' printfà utiliser pour créer une chaîne pour envoyer à l'unité de vidage.
Notes
La forme abrégée d' ATLTRACE2 écrit une chaîne dans la fenêtre Sortie du débogueur.La deuxième forme d' ATLTRACE2 écrit également la sortie dans la fenêtre Sortie du débogueur, mais est sujette aux paramètres de l'outil de ATL/MFC trace tool (voir l' Exemple ATLTraceTool).Par exemple, si vous définissez level à 4 et l'outil de ATL/MFC trace tool au niveau 0, vous ne verrez pas le message.le niveau peut être 0, 1, 2, 3, ou 4.La valeur par défaut, 0, indique que la plupart des problèmes graves.
Les listes de paramètres d' category les indicateurs de suivi à définir.Ces indicateurs correspondent aux types de méthodes pour lesquelles vous souhaitez enregistrer.Les tableaux ci-dessous la liste des indicateurs de suivi valides que vous pouvez utiliser pour le paramètre d' category .
Indicateurs de suivi ATL
Catégorie d'ATL |
Description |
|---|---|
atlTraceGeneral |
États de toutes les applications ATL.Valeur par défaut. |
atlTraceCOM |
Rapports sur les méthodes COM. |
atlTraceQI |
Rapports sur des appels de QueryInterface. |
atlTraceRegistrar |
Rapports sur l'inscription des objets. |
atlTraceRefcount |
États de modifier le décompte de références. |
atlTraceWindowing |
Rapports sur les méthodes de windows ; par exemple, rapports un ID non valide de table des messages |
atlTraceControls |
Rapports sur les contrôles ; par exemple, états lorsqu'un contrôle ou sa fenêtre est détruit. |
atlTraceHosting |
États de l'hébergement des messages ; par exemple, états lorsqu'un client dans un conteneur est activé. |
atlTraceDBClient |
Rapports du modèle du consommateur OLE DB ; par exemple, lorsqu'un appel à GetData échoue, la sortie peut contenir un HRESULT. |
atlTraceDBProvider |
Rapports du modèle de fournisseur OLE DB ; par exemple, indique si la création d'une colonne a échoué. |
atlTraceSnapin |
États de l'application de composant logiciel enfichable MMC. |
atlTraceNotImpl |
Indique que la fonction indiquée n'est pas implémentée. |
atlTraceAllocation |
Enregistre les messages imprimés par les outils de débogage de mémoire dans atldbgmem.h. |
Indicateurs de suivi MFC
Catégorie de MFC |
Description |
|---|---|
traceAppMsg |
Utilisation universel, messages MFC.Toujours recommandé. |
traceDumpContext |
Messages d' CDumpContext. |
traceWinMsg |
Messages du code de gestion des messages MFC. |
traceMemory |
Messages du code de gestion de la mémoire MFC. |
traceCmdRouting |
Messages du code de routage de commandes windows MFC. |
traceHtml |
Messages de la prise en charge de dialogue DHTML MFC. |
traceSocket |
Messages de la prise en charge du socket MFC. |
traceOle |
Messages de OLE prise en charge MFC. |
traceDatabase |
Messages de la prise en charge des bases de données MFC. |
traceInternet |
Messages de la prise en charge de Internet MFC. |
Pour déclarer une catégorie personnalisée de trace, déclarez une instance globale de la classe d' CTraceCategory comme suit :
CTraceCategory MY_CATEGORY(_T("MyCategoryName"), 1);
Le nom de catégorie, MY_CATEGORY dans cet exemple, est le nom que vous spécifiez à category le paramètre.Le premier paramètre est le nom de catégorie qui apparaîtra dans l'outil de ATL/MFC trace tool.Le second paramètre est le niveau de traçage par défaut.Ce paramètre est facultatif, et le niveau de traçage par défaut est 0.
Pour utiliser une catégorie définie par l'utilisateur :
ATLTRACE2(MY_CATEGORY, 2, _T("a message in a custom category"));
Pour spécifier que vous souhaitez filtrer les messages de trace, définitions d'insertion pour ces macros dans Stdafx.h avant l'instruction d' #include <atlbase.h> .
Sinon, vous pouvez définir le filtre dans les directives de préprocesseur dans la boîte de dialogue Pages de propriétés .Cliquez sur l'onglet de Préprocesseur puis insérez le global dans la zone d'édition de Définitions de préprocesseur .
Atlbase.h contient les définitions par défaut des macros d' ATLTRACE2 et ces définitions sont utilisées si vous ne définissez pas ces symboles avant atlbase.h soit traité.
Dans les versions release, compile d' ATLTRACE2 à (void) 0.
ATLTRACE2 limite le contenu de la chaîne à envoyer à l'unité de vidage à - pas plus de 1023 caractères, après la mise en forme.
ATLTRACE et ATLTRACE2 ont le même comportement, ATLTRACE est inclus pour la compatibilité descendante.
Exemple
int i = 1;
ATLTRACE2(atlTraceGeneral, 4, "Integer = %d\n", i);
// Output: 'Integer = 1'
Configuration requise
En-tête : atltrace.h