ATLTRACE2 (DWORD Категорія, UINT рівні, LPCSTR lpszFormat,...)
Параметри
категорія
[в] AtlTraceFlags його тип події або методом на якому доповіді. Перегляньте Зауваження список категорій.
рівень
[в] Рівень трасування доповіді. Має бути менше або дорівнює значення, задане для ATL_TRACE_LEVEL з'являтися. Наприклад, якщо встановити рівень 4 і ATL_TRACE_LEVEL на 0, ви побачите без попереджень. Перегляньте Зауваження для отримання додаткових відомостей про ATL_TRACE_LEVEL.
lpszFormat
[в] Відформатовану рядок для надсилання дампу пристрою.
Зауваження
Використання ATLTRACE2 для потреб відлагодження. ATLTRACE2 надає повідомлення про те, як події та методи happe&n.nbsp; ATLTRACE2 повідомляє попередження та помилки, які відбуваються, як ви налагодити програму. ATLTRACE2 надсилає відформатовану рядок, lpszFormat, дамп пристрою, зазвичай вікно налагоджувача виводу або файл.
Перший параметр для ATLTRACE2, Категорія, списки трасування прапори, набір. Ці прапори відповідають типи методів, для якого ви бажаєте доповісти. Наведена нижче таблиця містить список дійсний трасування прапори, які можна використовувати для параметра Категорія.
| Категорія | Опис |
| atlTraceUser | Визначений у застосунку. Значення вказує на рівень попередження, доповіді. |
| atlTraceGeneral | Звіти про всі додатки ATL. За замовчуванням. |
| atlTraceCOM | Звіти про методи COM. |
| atlTraceQI | Звіти про QueryInterface дзвінки. |
| atlTraceRegistrar | Звіти про реєстрацію об'єктів. |
| atlTraceRefcount | Звіти про зміну кількість посилань. |
| atlTraceWindowing | Звіти про windows методи, наприклад повідомляє повідомлення неприпустимий Ідентифікатор карта. |
| atlTraceControls | Звіти про елементи керування, наприклад, звітів, коли знищені елемента керування або вікна, що його. |
| atlTraceHosting | Звіти хостинг повідомлень, наприклад, коли активовано клієнта в контейнер. |
| atlTraceDBClient | Звіти про OLE DB споживача шаблон; наприклад коли заклик до GetData не вдається, вивід може містити HRESULT. |
| atlTraceDBProvider | Звіти про OLE DB постачальник шаблон, наприклад, звітів, якщо помилка створення стовпця. |
| atlTraceSnapin | Звіти про застосування оснастки консолі MMC. |
| atlTraceNotImpl | Повідомляє, що вказані функції не реалізовано. |
Приклад
/ / приклад для ATLTRACE2
Int я = 1;
ATLTRACE2 (atlTraceGeneral, 4, «ціле число = %d\n ", я);
/ / Виводу: ' ціле число = 1'
Можна фільтрувати за певних категорій і рівнів на рівні проекту шляхом встановлення двох глобальні функції, описані нижче. Щоб указати такі фільтрації в препроцесора визначень, вставте глобальні функції Stdafx.h перед на #include lt;atlbase.h> Заява.
По черзі, ви можете встановити фільтр у препроцесора директиви в діалоговому вікніПараметри проекту. Перейдіть на вкладку C/c + + і вставте глобальної у полі препроцесора визначень .
Щоб встановити категорії та рівні, використовувати такі функції глобального:
ATL_TRACE_CATEGORY 0XFFFFFFFF
Встановлює трасування категорію для фільтрування. За замовчуванням, 0xFFFFFFFF доповіді всі категорії. Для добору для певної категорії або наборі категорій, замінити 0xFFFFFFFF назви категорій трасування. Ви можете використовувати порозрядне OR оператор (|) для добору для більш ніж однієї категорії. Наприклад, встановивши ATL_TRACE_CATEGORY (atlTraceControls | atlTraceWindowing), ви побачите тільки ATLTRACE2 попередження для контролю і Віконна.
ATL_TRACE_LEVEL 0
Налаштовує рівень трасування, для яких фільтрування. Може бути, 0, 1, 2, 3 або 4. За промовчанням, 0, повідомляє лише найбільш серйозні проблеми. Замінити 0 на рівні звітності, ви хочете побачити. Наприклад, вказавши 4, ви побачите всі рівні попередження та інформаційні повідомлення.
ATL макроси та глобальні функції
Дивіться також