ATLTRACE2 (DWORD kategorii, UINT poziom, LPCSTR lpszFormat,...)
Parametry
kategoria
[w] AtlTraceFlags aby wskazać typ zdarzenia lub metoda złożenia raportu. Zobacz uwagi na liście kategorii.
poziom
[w] Poziom śledzenia do raportu. Musi być mniejsza lub równa wartości ustawione dla ATL_TRACE_LEVEL się. Na przykład jeśli poziom 4 i ATL_TRACE_LEVEL ustawiony na 0, zostanie wyświetlony nie ostrzeżenia. Aby uzyskać więcej informacji na temat ATL_TRACE_LEVEL , zobacz uwagi.
lpszFormat
[w] Sformatowany ciąg do wysłania do urządzenia zrzutu.
Uwagi
Dla celów debugowa&nia, należy użyć ATLTRACE2 . ATLTRACE2 zawiera wiadomości o tym, jak happen.nbsp zdarzeń i metod; ATLTRACE2 raportuje ostrzeżeń i błędów występujących jako debugowanie programu. ATLTRACE2 wysyła sformatowany ciąg, lpszFormat, urządzenie zrzutu, zazwyczaj w oknie dane wyjściowe debugera lub pliku.
Pierwszy parametr dla ATLTRACE2, kategorii, Wyświetla flagi śledzenia, aby ustawić. Te flagi odpowiadają rodzajów metod, dla których chcesz zgłosić. W poniższej tabeli wymieniono flagi śledzenia ważne, używanych dla parametru kategorii.
| Kategoria | Opis |
| atlTraceUser | Zdefiniowane przez aplikację. Wartość wskazuje poziom ostrzeżeń do raportu. |
| atlTraceGeneral | Raporty w sprawie wszystkich wniosków ATL. Domyślnie. |
| atlTraceCOM | Sprawozdania w sprawie metody COM. |
| atlTraceQI | Sprawozdania w sprawie wywołania metody QueryInterface mające. |
| atlTraceRegistrar | Sprawozdania w sprawie rejestracji obiektów. |
| atlTraceRefcount | Sprawozdania na temat zmieniania licznika odwołań. |
| atlTraceWindowing | Sprawozdania w sprawie metod systemu windows, na przykład raporty identyfikator mapy nieprawidłowy komunikat. |
| atlTraceControls | Sprawozdania z kontroli, na przykład raporty, kiedy niszczony jest formant lub jego okno. |
| atlTraceHosting | Raporty obsługi wiadomości, na przykład, po uaktywnieniu klienta w pojemniku. |
| atlTraceDBClient | Raporty szablonie OLE DB konsumenta; na przykład gdy wywołanie GetData ulegnie awarii, dane wyjściowe mogą zawierać HRESULT. |
| atlTraceDBProvider | Sprawozdania na temat OLE DB Provider szablon, na przykład raporty, jeśli utworzenie kolumny nie powiodło się. |
| atlTraceSnapin | Raporty dla aplikacji konsoli MMC. |
| atlTraceNotImpl | Raportuje, że wskazana funkcja nie jest zaimplementowana. |
Przykład
/ / przykład ATLTRACE2
int i = 1;
ATLTRACE2 (atlTraceGeneral, 4, "Integer = %d\n", i);
/ Wyjście: "Integer = 1'
Można filtrować określone kategorie i poziomy na poziomie projektu przez ustawienie dwie funkcje globalne, opisane poniżej. Aby określić takie filtrowania w definicjach preprocesora, włóż funkcje globalne do Stdafx.h przed #include lt;atlbase.h> oświadczenie.
Ewentualnie można ustawić filtr w dyrektywy preprocesora w oknie dialogowymUstawienia projektu. Kliknij kartę C/C++ , a następnie Wstaw globalnym w polu edycji definicji preprocesora .
Aby ustawić kategorie i poziomy, należy użyć następujących funkcji globalnych:
ATL_TRACE_CATEGORY 0XFFFFFFFF
Ustawia kategoria Trop, dla którego ma zostać wykonane filtrowanie. Domyślnie 0xFFFFFFFF raportuje wszystkie kategorie. Aby filtrować dla określonej kategorii lub zestawu kategorii, należy zastąpić 0xFFFFFFFF nazwy kategorii, którą chcesz śledzenia. Można użyć logiczną lub operatora (|) do filtrowania dla więcej niż jednej kategorii. Na przykład ustawiając ATL_TRACE_CATEGORY (atlTraceControls | atlTraceWindowing), widoczny będzie tylko ATLTRACE2 ostrzeżenia dla formantów i okienkowy.
ATL_TRACE_LEVEL 0
Ustawia poziom śledzenia, dla którego ma zostać wykonane filtrowanie. Może być 0, 1, 2, 3 lub 4. Domyślnie, 0, raportuje tylko najpoważniejszych problemów. Zastąp 0 poziom raportowania, że użytkownik chce zobaczyć. Na przykład określając 4, zobaczysz wszystkie poziomy ostrzeżeń i komunikatów informacyjnych.
Zobacz też