ATLTRACE2
Предупреждения отчетов на устройстве вывода, например окно отладчика, отображаемым в соответствии с флажкам и слоями.
ATLTRACE2( exp );
ATLTRACE2(
DWORD category,
UINT level,
LPCSTR lpszFormat,
...
);
Параметры
exp
[in] строки, чтобы отправить в окне вывода Visual C или C-++ любому приложению, ловушки эти сообщения.category
[in] тип события или метод, для которого необходимо получить. См. примечания список категорий.level
[in] уровень трассировки, который уведомляет. См. примечания для сведения.lpszFormat
[in] строка формата printf в стиле, используемый для создания строки для отправки на устройстве резервного копирования.
Заметки
Сокращенная форма ATLTRACE2 записывает строку в окне вывода отладчика. Вторая форма ATLTRACE2 также записывает выходные данные в окне вывода отладчика, но и параметры средства трассировки ATL/MFC (см. Образец ATLTraceTool). Например, если свойству level задано значение 4, а средства трассировки ATL/MFC на уровне 0, пользователь не увидит сообщение. уровень может быть 0, 1, 2, 3 или 4. Значение по умолчанию - 0, отчеты только наиболее серьезные проблемы.
Списки параметров category флажки трассировки, настройку. Эти флажки соответствуют типам методов, для которых нужно получить. Список таблиц ниже допустимые флажки трассировки можно использовать для параметра category.
Флажки трассировки ATL
Категория ATL |
Описание |
|---|---|
atlTraceGeneral |
Отчет все приложения библиотеки ATL. Это значение используется по умолчанию. |
atlTraceCOM |
Методы модели COM отчет. |
atlTraceQI |
Вызовы QueryInterface отчет. |
atlTraceRegistrar |
Отчет " регистрация объектов. |
atlTraceRefcount |
Отчет о изменения счетчик ссылок. |
atlTraceWindowing |
Методы окна отчета; например, отчеты недопустимый идентификатор схемы сообщений |
atlTraceControls |
Управления отчета; например, если отчеты будут уничтожены элемент управления или его окно. |
atlTraceHosting |
Отчеты размещения сообщения; например, отчеты, если будет активирован клиент в контейнере. |
atlTraceDBClient |
Шаблон объект-получателя OLE DB отчета; например, когда вызов GetData завершается сбоем, результат может содержать HRESULT. |
atlTraceDBProvider |
Шаблон поставщика OLE DB отчета; например, если отчеты создание столбца завершается ошибкой. |
atlTraceSnapin |
Отчеты для приложения оснастки консоли управления (MMC). |
atlTraceNotImpl |
Отчеты, показанная функция не реализована. |
atlTraceAllocation |
Сообщения отчетов напечатали средствами отладки памяти в atldbgmem.h. |
Флажки трассировки MFC
Категория MFC |
Описание |
|---|---|
traceAppMsg |
Общего назначения, сообщения MFC. Рекомендуется всегда. |
traceDumpContext |
Сообщения из CDumpContext. |
traceWinMsg |
Сообщения из кода обработки сообщений MFC. |
traceMemory |
Сообщения из кода управления памятью MFC. |
traceCmdRouting |
Сообщения из кода маршрутизации команд Windows MFC. |
traceHtml |
Сообщения от поддержки диалоговое окно DHTML MFC. |
traceSocket |
Сообщения от поддержки сокетов MFC. |
traceOle |
Сообщения от поддержки MFC OLE. |
traceDatabase |
Сообщения от поддержки баз данных MFC. |
traceInternet |
Сообщения от поддержки MFC для работы в Интернете. |
Для объявления пользовательскую категорию трассировки объявите глобальный экземпляр класса CTraceCategory следующим образом:
CTraceCategory MY_CATEGORY(_T("MyCategoryName"), 1);
Имя категории, MY_CATEGORY в этом примере имя указано в параметре category. Первый параметр имя категории, которое появится в средство трассировки ATL/MFC. Второй параметр уровень трассировки по умолчанию. Этот параметр является необязательным и уровень трассировки по умолчанию 0.
Использование определяемых пользователем категория:
ATLTRACE2(MY_CATEGORY, 2, _T("a message in a custom category"));
Указать, что требуется фильтрации сообщений трассировки, определения вставки для этих макросов в файл Stdafx.h перед выпиской #include <atlbase.h>.
Кроме того, можно задать фильтр в директивах препроцессора в диалоговом окне Страницы свойств. Щелкните вкладку ПРЕПРОЦЕССОР и затем вставьте глобальное ввода в поле Определения препроцессора.
Atlbase.h содержит определения по умолчанию макросов ATLTRACE2 и эти определения будут использоваться, если не указаны эти символы, прежде чем atlbase.h обрабатывается.
В построениях выпуска, ATLTRACE2 будет компилироваться в (void) 0.
ATLTRACE2 ограничивает содержимое строки для отправки на устройстве резервного копирования на не более 1023 символов, после форматирования.
ATLTRACE и ATLTRACE2 имеют одинаковое расширение функциональности, ATLTRACE включены для обратной совместимости.
Пример
int i = 1;
ATLTRACE2(atlTraceGeneral, 4, "Integer = %d\n", i);
// Output: 'Integer = 1'
Требования
Header: atltrace.h