макрос WIAS_LTRACE (wiautil.h)

Статья
02/07/2025

Макрос WIAS_LTRACE устарел. Вместо этого рекомендуется использовать макрос WIAS_TRACE.

Макрос WIAS_LTRACE записывает в файл журнала диагностический WIA_TRACE сообщение.

Синтаксис

void WIAS_LTRACE(
   x,
   y,
   z,
   params
);

Параметры

x

y

z

params

DetailLevel — указывает уровень сведений о диагностике сообщения. Этот параметр может быть одним из следующих значений.

Ценность	Описание
WIALOG_LEVEL1	Регистрирует точки входа и выхода для всех методов и функций WIA.
WIALOG_LEVEL2	Записывает дополнительные сведения для WIALOG_LEVEL1.
WIALOG_LEVEL3	Регистрирует точки входа и выхода для всех методов и функций WIA и дополнительных предоставляемых поставщиком функций.
WIALOG_LEVEL4	Записывает дополнительные сведения для WIALOG_LEVEL3.
WIALOG_LEVELXXX	Определяемые пользователем уровни журналов.

ResourceID — указывает идентификатор ресурса. Это значение должно иметь значение WIALOG_NO_RESOURCE_ID.
format_string — задает список аргументов переменной, который начинается со строки формата ANSI, описывающей сообщение и любые идентификаторы формата. Многоточие (...) указывает переменное число аргументов, которые должны быть выходными. Текст ошибки должен быть префиксирован с полным именем метода или функции и создать сообщение в формате "class::method, error-text".
pIWiaLog — указатель на интерфейс IWiaLog.

Возвращаемое значение

Никакой

Замечания

Ниже приведен пример использования макроса:

WIAS_LTRACE(g_pIWiaLog, WIALOG_NO_RESOURCE_ID, WIALOG_LEVEL2,
  ("MyClass::MyMethod, This is my text and my lValue = %d", lValue));

Использование макроса WIAS_LTRACE не рекомендуется, так как он не записывает выходные данные в файл журнала диагностики Wiatrace.log. Вместо этого рекомендуется использовать макрос WIAS_TRACE.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Устаревший. Вместо этого используйте WIAS_TRACE.
целевая платформа	Настольный
заголовка	wiautil.h (include Wiautil.h)

См. также

Поделиться через