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

Вызов SetupWriteTextLog

  • Статья

SetupWriteTextLog добавляет одну запись с информацией о событии установки в текстовый журнал SetupAPI.

Как описано в разделе Формат текста раздела журнала, формат записи журнала состоит из следующих полей:

entry_prefix time_stamp event_category indentation formatted_message

Чтобы вызвать SetupWriteTextLog, приложение предоставляет следующие сведения:

  • Маркер журнала для раздела в текстовом журнале, полученного путем вызова SetupGetThreadLogToken или одного из системных маркеров журнала. Если маркер журнала связан с текстовым разделом журнала, SetupWriteTextLog записывает запись журнала в этом разделе. В противном случае SetupWriteTextLog добавляет запись журнала в часть журнала, не включенную в текстовый раздел журнала. Кроме того, указывает, записывает ли SetupWriteTextLog запись журнала и в какой текстовый журнал SetupWriteTextLog записывает запись, зависит от значения токена журнала, определенного системой.

    Дополнительные сведения о маркерах журнала см. в разделе Настройка и получение маркера журнала для потока.

  • Одна из категорий событий, описанных в разделе Включение категорий событий для текстового журнала. Если категория событий для записи включена для текстового журнала, SetupWriteTextLog добавляет запись в текстовый журнал; В противном случае SetupWriteTextLog не записывает запись в текстовый журнал.

  • Значение флага, представляющее побитовую ИЛИ системных констант, которые определяют уровень событий, глубину отступов и необходимость включения метки времени. Уровни событий описаны в разделе Настройка уровня событий для текстового журнала. Если уровень событий, заданный для текстового журнала, больше или равен уровню событий для записи, SetupWriteTextLog записывает запись журнала в текстовый журнал; В противном случае SetupWriteTextLog не записывает запись журнала в текстовый журнал. С помощью отступов можно упорядочить отформатированные сообщения, чтобы упростить чтение и понимание сведений в разделе. Дополнительные сведения см. в статье Запись записей журнала с отступом.

  • Строка формата, совместимая с printf, которая форматирует как сообщение, так и список переменных, разделенных запятыми, которые следует за строкой формата.

  • Разделенный запятыми список переменных, значения которых форматируются строкой формата, совместимой с printf.

Пример вызова SetupWriteTextLog для записи в журнал сведений о событии, которое не является ошибкой или предупреждением, см. в статье Запись в журнал сведений.

Пример вызова SetupWriteTextLog для записи в журнал сведений об ошибке или предупреждении см. в статье Запись журнала ошибок или предупреждений.