ATLTRACE2 (DWORD Kategorie, UINT Ebene, LPCSTR LpszFormat,...)
Parameter
kategorie
[in] Die AtlTraceFlags um den Typ von Ereignis oder eine Methode auf dem Bericht anzugeben. Eine Liste der Kategorien finden Sie unter Hinweise.
ebene
[in] Die Ebene der Ablaufverfolgung zu berichten. Muss kleiner als oder gleich dem Wert für ATL_TRACE_LEVEL angezeigt werden. Zum Beispiel, wenn Sie Ebene 4 und ATL_TRACE_LEVEL auf 0 festlegen, sehen Sie keine Warnungen. Weitere Informationen zu ATL_TRACE_LEVEL finden Sie unter Hinweise.
lpszFormat
[in] Der formatierten Zeichenfolge, an der Dump-Gerät senden.
Bemerkungen
Verwenden Sie ATLTRACE2 für debugging-Zwecke. ATLTRACE2 bietet &Nachrichten darüber, wie Ereignisse und Methoden happen.nbsp; ATLTRACE2 Berichte, Warnungen und Fehler, die auftreten, wenn Sie das Programm debuggen. ATLTRACE2 sendet eine formatierte Zeichenfolge, LpszFormat, an einer Dump-Gerät, in der Regel die Debugger-Ausgabefenster oder einer Datei.
Der erste Parameter für ATLTRACE2, Kategorie, listet die Ablaufverfolgungsflags festgelegt. Diese Flags entsprechen den Methoden für die Sie melden möchten. Die folgende Tabelle enthält die gültigen Ablaufverfolgungsflags können, die Sie für den Category -Parameter verwenden.
| Kategorie | Beschreibung |
| atlTraceUser | Anwendungsdefinierte. Der Wert gibt den Grad der Warnungen zu berichten. |
| atlTraceGeneral | Berichte über alle ATL-Anwendungen. Der Standard. |
| atlTraceCOM | Berichte über die COM-Methoden. |
| atlTraceQI | Berichte über QueryInterface-Aufrufe. |
| atlTraceRegistrar | Berichte über die Registrierung von Objekten. |
| atlTraceRefcount | Berichte zum Ändern der Verweiszähler. |
| atlTraceWindowing | Berichte über die Windows-Methoden, z. B. meldet eine ungültige Nachrichtenkennung Karte. |
| atlTraceControls | Berichte über Steuerelemente, z. B. Berichte, wenn ein Steuerelement oder Fenster zerstört wird. |
| atlTraceHosting | Berichte, Nachrichten, z. B. hosting, wenn ein Client in einem Container aktiviert ist. |
| atlTraceDBClient | Berichte über die OLE DB-Consumers Vorlage; zum Beispiel kann wenn ein Aufruf von GetData fehlschlägt, die Ausgabe der HRESULT enthalten. |
| atlTraceDBProvider | Berichte über OLE DB Providervorlage, z. B. Berichte, wenn Fehler beim Erstellen einer Spalte. |
| atlTraceSnapin | Reportagen für MMC-Snap-in-Anwendung. |
| atlTraceNotImpl | Meldet, dass die angegebene Funktion nicht implementiert ist. |
Beispiel
/ / Beispiel für ATLTRACE2
Int I = 1;
ATLTRACE2 (AtlTraceGeneral, 4, "Integer = %d\n", ich);
/ / Ausgabe: ' Integer = 1'
Sie können filter für bestimmte Kategorien und Ebenen auf Projektebene durch Festlegen der zwei globalen Funktionen beschrieben. Um solche Filterung in die Präprozessor-Definitionen anzugeben, legen Sie die globalen Funktionen in Stdafx.h vor der #include lt;atlbase.h> Anweisung.
Alternativ können Sie den Filter in die Präprozessor-Direktiven im Dialogfeld "Einstellungen "festlegen. Klicken Sie auf die Registerkarte C/c++ , und legen Sie dann die globale in dem Eingabefeld Präprozessordefinitionen .
Um die Kategorien und Ebenen festzulegen, verwenden Sie die folgenden globalen Funktionen:
ATL_TRACE_CATEGORY 0XFFFFFFFF
Legt die Ablaufverfolgungskategorie für den filter. Der Standardwert 0xFFFFFFFF meldet alle Kategorien. Um für eine bestimmte Kategorie oder Kategorien zu filtern, ersetzen Sie "0xffffffff" mit den Kategorienamen, die Sie verfolgen möchten. Können Sie das bitweise OR Operator (|) für mehr als eine Kategorie zu filtern. Z. B. durch Festlegen von ATL_TRACE_CATEGORY (AtlTraceControls | AtlTraceWindowing), sehen Sie für Steuerelemente und Windowing nur ATLTRACE2 Warnungen.
ATL_TRACE_LEVEL 0
Legt die Ablaufverfolgungsebene für den filter. 0, 1, 2, 3 Oder 4 kann sein. Die Standardeinstellung 0, meldet nur die schwerwiegendsten Probleme. Ersetzen Sie 0 mit der Meldung, dass Sie sehen wollen. Z. B. durch Angabe 4, sehen alle Ebenen der Warnungen und Informationsmeldungen Sie.
ATL-Makros und globale Funktionen
Siehe auch