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, например сообщает ID карты Недопустимое сообщение. |
| atlTraceControls | Доклады на элементах управления, например сообщает, когда элемент управления или его окно уничтожается. |
| atlTraceHosting | Доклады, хостинг сообщений, например, когда клиент в контейнере активируется. |
| atlTraceDBClient | Доклады о потребителя OLE DB шаблона; когда не вызов метода GetData, выходных данных может содержать, например HRESULT. |
| atlTraceDBProvider | Доклады о шаблонов поставщика OLE DB, например сообщает, если сбой при создании столбца. |
| atlTraceSnapin | Доклады для оснастка MMC приложения. |
| atlTraceNotImpl | Сообщает, что указанные функция не реализована. |
Пример
/ / Пример для ATLTRACE2
int I = 1;
ATLTRACE2 (atlTraceGeneral, 4, "Integer = %d\n", я);
/ / Вывод: «Integer = 1'
Можно фильтровать для конкретных категорий и уровней на уровне проекта, установив две глобальные функции, описанные ниже. Чтобы задать такой фильтрации в определения препроцессора, вставьте глобальных функций в Stdafx.h до #include lt;atlbase.h> заявление.
Кроме того можно задать фильтр в директивы препроцессора в диалоговом окнеПараметры проекта. Перейдите на вкладку C/C++ , а затем вставить глобальной в поле редактирования определения препроцессора .
Чтобы задать категории и уровни, используйте следующие глобальные функции:
ATL_TRACE_CATEGORY 0XFFFFFFFF
Задает категорию трассировки для фильтрации. По умолчанию 0xFFFFFFFF доклады всех категорий. Для фильтрации для конкретной категории или набор категорий, замените имена категорий, которые вы хотите отслеживать 0xFFFFFFFF . Вы можете использовать операцию побитового или (|) оператор для фильтрации для более чем одной категории. К примеру, установив ATL_TRACE_CATEGORY (atlTraceControls | atlTraceWindowing), вы увидите только ATLTRACE2 предупреждения для элементов управления и управления окнами.
ATL_TRACE_LEVEL 0
Определяет уровень трассировки для фильтрации. Может быть 0, 1, 2, 3 или 4. Значение по умолчанию 0, сообщает только наиболее серьезные проблемы. Замените 0 на уровень отчетности, вы хотите увидеть. К примеру путем задания 4, вы увидите все уровни предупреждений и информационных сообщений.
Глобальные функции и макросы ATL
Родственные слова