ATLTRACE2
Zprávy upozornění na výstupní zařízení, jako je například okno debugger podle uvedených příznaků a úrovně.
ATLTRACE2( exp );
ATLTRACE2(
DWORD category,
UINT level,
LPCSTR lpszFormat,
...
);
Parametry
exp
[v] Řetězec, který se má poslat v okně Výstup Visual C++ nebo libovolné aplikace, která provádí soutisk těchto zpráv.category
[v] Typ události nebo metoda kdy do sestavy.Zobrazit poznámky pro seznam kategorií.level
[v] Úroveň trasování do sestavy.Zobrazit poznámky pro podrobnosti.lpszFormat
[v] printf-Styl formátovací řetězec použitý k vytvoření řetězce k odeslání zařízení s výpisem stavu paměti.
Poznámky
Zkratka pro ATLTRACE2 zapíše řetězec do ladicího programu společnosti output window.Druhá forma ATLTRACE2 také zapíše výstup v okně výstupu ladicího programu, ale podléhá nastavení trasovacího nástroje ATL/MFC (viz Vzorku ATLTraceTool).Nastavíte-li například level 4 a trasovacího nástroje ATL/MFC na úroveň 0, je zpráva se nezobrazí.úroveň může být 0, 1, 2, 3 nebo 4.Výchozí hodnota 0, hlásí pouze nejzávažnější problémy.
category Parametru jsou uvedeny příznaky trasování nastavení.Tyto příznaky odpovídají typům metod, které chcete do sestavy.Níže uvedených tabulkách jsou uvedeny platné trasování příznaky, můžete použít pro category parametr.
Příznaky trasování ATL
Kategorie knihovny ATL |
Description |
|---|---|
atlTraceGeneral |
Zprávy o všech aplikacích knihovny ATL.Výchozí nastavení. |
atlTraceCOM |
Zprávy o metody COM. |
atlTraceQI |
Zprávy o volání funkce QueryInterface. |
atlTraceRegistrar |
Zprávy o registraci objektů. |
atlTraceRefcount |
Zprávy o změně počet odkazů. |
atlTraceWindowing |
Zprávy o windows metody; například zprávy neplatné ID zprávy mapy. |
atlTraceControls |
Zprávy o ovládací prvky; například sestavy v případě, že ovládací prvek nebo jeho okno zničen. |
atlTraceHosting |
Sestavy, které jsou hostiteli zprávy; například sestavy při aktivaci klienta v kontejneru. |
atlTraceDBClient |
Zprávy o šablony příjemce technologie OLE DB; například při volání GetData selže, může výstup obsahuje hodnota HRESULT. |
atlTraceDBProvider |
Zprávy o šablony zprostředkovatele technologie OLE DB; například zprávy, pokud se nezdařilo vytvoření sloupce. |
atlTraceSnapin |
Sestavy pro použití modulu snap-in konzoly MMC. |
atlTraceNotImpl |
Hlásí, že uvedené funkce není implementována. |
atlTraceAllocation |
Hlásí zprávy vytištěné paměti ladicí nástroje v atldbgmem.h. |
Příznaky trasování knihovny MFC
Kategorie knihovny MFC |
Description |
|---|---|
traceAppMsg |
Obecné použití zpráv knihovny MFC.Vždy je doporučeno. |
traceDumpContext |
Zprávy z CDumpContext. |
traceWinMsg |
Zprávy z knihovny MFC zprávy kód pro zpracování. |
traceMemory |
Zprávy z kódu, správu paměti MFC. |
traceCmdRouting |
Zprávy z knihovny MFC Windows příkaz směrovací kód. |
traceHtml |
Zprávy z podpory dialogové okno DHTML knihovny MFC. |
traceSocket |
Zprávy z podpory soketů knihovny MFC. |
traceOle |
Zprávy z podporu technologie OLE knihovny MFC. |
traceDatabase |
Zprávy z podpory databáze knihovny MFC. |
traceInternet |
Zprávy z Internetu podporu knihovny MFC. |
Chcete-li deklarovat vlastní trasovací kategorie, deklarujte globální instanci CTraceCategory třídy takto:
CTraceCategory MY_CATEGORY(_T("MyCategoryName"), 1);
Název kategorie MY_CATEGORY v tomto příkladu je název, který zadáte do category parametr.První parametr je název kategorie, která se objeví v trasovacího nástroje ATL/MFC.Druhý parametr je výchozí úroveň trasování.Tento parametr je nepovinný a výchozí úroveň trasování je 0.
Chcete-li použít kategorií definovaných uživatelem:
ATLTRACE2(MY_CATEGORY, 2, _T("a message in a custom category"));
Chcete-li určit, které chcete filtrovat zprávy trasování, vložte do souboru stdafx před definice těchto maker #include <atlbase.h> prohlášení.
Alternativně můžete nastavit filtr do direktiv preprocesoru v Stránky vlastností dialogové okno.Klepněte preprocesoru kartu a poté vložte globální do Preprocesoru textové pole.
Atlbase.h obsahuje výchozí definice ATLTRACE2 makra a tyto definice bude použit, pokud nedefinujete tyto symboly před zpracováním atlbase.h.
Ve verzích pro produkční nasazení ATLTRACE2 zkompiluje do (void) 0.
ATLTRACE2omezuje obsah řetězce, které bude odesláno do zařízení, na více než 1023 znaků po formátování.
ATLTRACE a ATLTRACE2 mají stejné chování ATLTRACE je zahrnuta z důvodu zpětné kompatibility.
Příklad
int i = 1;
ATLTRACE2(atlTraceGeneral, 4, "Integer = %d\n", i);
// Output: 'Integer = 1'
Požadavky
Záhlaví: atltrace.h