ATLTRACE2 (DWORD catégorie, UINT niveau, LPCSTR lpszFormat,...)
Paramètres
catégorie
[en] atlTraceFlags pour indiquer le type d'événement ou de la méthode sur laquelle au rapport. Voir les remarques pour obtenir une liste de catégories.
niveau
[en] Le niveau de traçage au rapport. Doit être inférieure ou égale à la valeur que vous définissez pour ATL_TRACE_LEVEL de comparaître. Par exemple, si vous définissez le niveau 4 et ATL_TRACE_LEVEL à 0, vous ne verrez aucun avertissement. Voir les remarques pour plus d'informations sur ATL_TRACE_LEVEL.
lpszFormat
[en] La chaîne mise en forme à envoyer au périphérique de vidage.
Remarques
À des fi&ns de débogage, utilisez ATLTRACE2 . ATLTRACE2 fournit des messages sur l'happen.nbsp des événements et des méthodes ; ATLTRACE2 signale les avertissements et les erreurs qui se produisent comme vous déboguez le programme. ATLTRACE2 envoie une chaîne formatée, lpszFormat, d'un dispositif de vidange, habituellement la fenêtre sortie du débogueur ou dans un fichier.
Le premier paramètre ATLTRACE2, catégorie, répertorie les indicateurs de trace à définir. Ces indicateurs correspondent aux types de méthodes pour lesquelles vous souhaitez rapport. Le tableau ci-dessous répertorie les indicateurs de trace valide, que vous pouvez utiliser pour le paramètre category.
| Catégorie | Description |
| atlTraceUser | Définie par l'application. La valeur indique le niveau des avertissements au rapport. |
| atlTraceGeneral | Rapports sur toutes les applications ATL. La valeur par défaut. |
| atlTraceCOM | Rapports sur les méthodes COM. |
| atlTraceQI | Rapports sur les appels QueryInterface. |
| atlTraceRegistrar | Rapports sur l'enregistrement des objets. |
| atlTraceRefcount | Rapports sur l'évolution de décompte de références. |
| atlTraceWindowing | Rapports sur les méthodes de windows, par exemple les rapports un ID de message non valide (carte). |
| atlTraceControls | Rapports sur les contrôles, par exemple les rapports lorsque sa fenêtre ou un contrôle est détruite. |
| atlTraceHosting | Rapports d'hébergement des messages, par exemple, lorsqu'un client dans un conteneur est activé. |
| atlTraceDBClient | Rapports sur le modèle OLE DB consommation ; par exemple lorsqu'un appel de GetData échoue, la sortie peut contenir le HRESULT. |
| atlTraceDBProvider | Rapports sur les modèles du fournisseur OLE DB, par exemple les rapports si l'échec de la création d'une colonne. |
| atlTraceSnapin | Rapports pour l'application du composant logiciel enfichable MMC. |
| atlTraceNotImpl | Rapports que la fonction indiquée n'est pas implémentée. |
Exemple
/ / exemple de ATLTRACE2
int i = 1 ;
ATLTRACE2 (atlTraceGeneral, 4, « entier = %d\n ", i) ;
/ / Sortie: ' entier = 1'
Vous pouvez filtrer des niveaux et des catégories spécifiques au niveau du projet en définissant les deux fonctions globales décrites ci-dessous. Pour spécifier ce filtrage dans les définitions de préprocesseur, insérez les fonctions globales dans Stdafx.h avant la #include lt;atlbase.h> déclaration.
Alternativement, vous pouvez définir le filtre dans les directives de préprocesseur dans la boîte de dialogueparamètres de projet. Cliquez sur l'onglet C/C++ et puis insérez le global dans la zone d'édition de définitions de préprocesseur .
Pour définir les catégories et niveaux, utilisez les fonctions globales suivantes:
ATL_TRACE_CATEGORY 0XFFFFFFFF
Définit la catégorie de trace pour lequel filtrer. La valeur par défaut, toutes les catégories des rapports 0xFFFFFFFF . Pour filtrer une catégorie spécifique ou un ensemble de catégories, remplacez les noms de catégorie que vous souhaitez trace 0xFFFFFFFF . Vous pouvez utiliser l'opérateur de bits OR (|) opérateur pour filtrer plus d'une catégorie. Par exemple, en définissant ATL_TRACE_CATEGORY (atlTraceControls | atlTraceWindowing), vous verrez que ATLTRACE2 avertissements pour les commandes et fenêtrage.
ATL_TRACE_LEVEL 0
Définit le niveau de trace pour lequel filtrer. Peut être 0, 1, 2, 3 ou 4. La valeur par défaut, 0, ne rapporte que les problèmes les plus graves. Remplacez 0 par le niveau de rapport que vous voulez voir. Par exemple, en spécifiant le 4, vous verrez tous les niveaux des avertissements et des messages d'information.
Les Macros ATL et fonctions globales
Voir aussi