ATLTRACE2
Raporty ostrzeżenia na urządzeniu wyjściowym, takich jak okno debugera, zgodnie ze wskazanym flagi i poziomy.
ATLTRACE2( exp );
ATLTRACE2(
DWORD category,
UINT level,
LPCSTR lpszFormat,
...
);
Parametry
exp
[in] Ciąg, który można wysłać do okna dane wyjściowe Visual C++ lub dowolnej aplikacji, które pułapki tych komunikatów.category
[in] Typ zdarzenia lub metody, na którym do raportu.Patrz uwagi do listy kategorii.level
[in] Poziom śledzenia do raportu.Patrz uwagi, aby uzyskać szczegółowe informacje.lpszFormat
[in] printf-Styl ciąg formatu używać do tworzenia łańcuch do wysłania do urządzenia zrzutu.
Uwagi
Krótkiej formy ATLTRACE2 pisze ciąg do debugera wyjściowych okna.Druga forma ATLTRACE2 również zapisuje dane wyjściowe do okna Debuggera w danych wyjściowych, ale jest zgodnie z ustawieniami narzędzie śledzenia ATL/MFC (zobacz Próbki ATLTraceTool).Na przykład, jeśli ustawisz level do 4 i narzędzie śledzenia ATL/MFC do poziomu 0, nie zobaczysz komunikat.poziom może być 0, 1, 2, 3 lub 4.Domyślnie, 0, raportuje tylko najpoważniejszych problemów.
category Parametr zawiera listę flag śledzenia, aby ustawić.Flagi te odnoszą się do typów metod, dla których chcesz zgłosić.Poniższe tabele zawierają flagi śledzenia prawidłowe, można użyć dla category parametru.
Flagi śledzenia ATL
Kategoria ATL |
Opis |
|---|---|
atlTraceGeneral |
Raporty na temat wszystkich aplikacji ATL.Domyślny. |
atlTraceCOM |
Raporty na temat metod COM. |
atlTraceQI |
Sprawozdania dotyczące wywołania metody QueryInterface. |
atlTraceRegistrar |
Sprawozdania dotyczące rejestracji obiektów. |
atlTraceRefcount |
Raporty na temat zmieniania licznika odwołań. |
atlTraceWindowing |
Raporty na temat metod systemu windows; na przykład raporty nieprawidłowy identyfikator wiadomości mapy. |
atlTraceControls |
Sprawozdania w sprawie kontroli; na przykład raporty, kiedy niszczony jest formant lub jego okna. |
atlTraceHosting |
Raporty hosting wiadomości; na przykład raporty po uaktywnieniu klienta w pojemniku. |
atlTraceDBClient |
Raporty na szablonie OLE DB konsumenta; na przykład po wywołaniu metody GetData: kończy się niepowodzeniem, dane wyjściowe mogą zawierać HRESULT. |
atlTraceDBProvider |
Raporty na szablonie dostawca OLE DB; na przykład raporty, jeśli nie można utworzyć kolumnę. |
atlTraceSnapin |
Raporty dla aplikacji konsoli MMC. |
atlTraceNotImpl |
Raportuje, że wskazane funkcja nie jest zaimplementowana. |
atlTraceAllocation |
Wiadomości raporty drukowane przez pamięci narzędzia debugowania w atldbgmem.h. |
Flagi śledzenia MFC
Kategoria MFC |
Opis |
|---|---|
traceAppMsg |
Ogólnego przeznaczenia, MFC wiadomości.Zawsze jest to zalecane. |
traceDumpContext |
Wiadomości z CDumpContext. |
traceWinMsg |
Wiadomości z wiadomości MFC kodu. |
traceMemory |
Wiadomości z kodeksem zarządzania pamięci usługi MFC firmy. |
traceCmdRouting |
Wiadomości z systemu Windows MFC polecenia kod marszruty. |
traceHtml |
Wiadomości z obsługa okno DHTML MFC. |
traceSocket |
Wiadomości z wsparcie MFC. |
traceOle |
Wiadomości z obsługi MFC. |
traceDatabase |
Wiadomości z pomocy technicznej bazy danych MFC. |
traceInternet |
Wiadomości z Obsługa internetowego MFC. |
Aby zadeklarować kategoria Trop niestandardowe, należy zadeklarować globalnej instancji CTraceCategory klasy się następujące zmiany:
CTraceCategory MY_CATEGORY(_T("MyCategoryName"), 1);
Nazwa kategorii MY_CATEGORY w tym przykładzie jest nazwą określane w celu category parametru.Pierwszy parametr jest nazwę kategorii, która pojawi się w narzędzie śledzenia ATL/MFC.Drugi parametr jest domyślny poziom śledzenia.Ten parametr jest opcjonalny, a domyślny poziom śledzenia jest równa 0.
Aby użyć kategorii zdefiniowanej przez użytkownika:
ATLTRACE2(MY_CATEGORY, 2, _T("a message in a custom category"));
Aby określić, że chcesz filtrować wiadomości śledzenia, należy wstawić definicje dla tych makr do Stdafx.h przed #include <atlbase.h> instrukcji.
Alternatywnie, można ustawić filtr w dyrektywy preprocesora w Stron właściwości okno dialogowe.Kliknij przycisk Preprocessor kartę, a następnie wstawić globalne w Definicje Preprocessor polu edycji.
Atlbase.h zawiera definicje domyślne ATLTRACE2 makr i definicje te będą używane, jeśli nie określają te symbole, przed przetworzeniem atlbase.h.
W trybie budowania wersji ATLTRACE2 kompiluje do (void) 0.
ATLTRACE2ogranicza zawartość ciąg do wysłania do urządzenia zrzutu do nie więcej niż 1023 znaków, po zakończeniu formatowania.
ATLTRACE i ATLTRACE2 mają takie samo zachowanie, ATLTRACE jest uwzględniony w zgodności z poprzednimi wersjami.
Przykład
int i = 1;
ATLTRACE2(atlTraceGeneral, 4, "Integer = %d\n", i);
// Output: 'Integer = 1'
Wymagania
Nagłówek: atltrace.h