Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais

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,
   ...
);

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.

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

Afficher: