Функция SetupWriteTextLogInfLine (setupapi.h)

Функция SetupWriteTextLogInfLine записывает запись журнала в текстовый журнал SetupAPI , содержащий текст указанной строки INF-файла.

Синтаксис

WINSETUPAPI VOID SetupWriteTextLogInfLine(
  [in] SP_LOG_TOKEN LogToken,
  [in] DWORD        Flags,
  [in] HINF         InfHandle,
  [in] PINFCONTEXT  Context
);

Параметры

[in] LogToken

Маркер журнала, который является системным маркером журнала или возвращен программой SetupGetThreadLogToken.

[in] Flags

Значение типа DWORD, представляющее собой побитовое ИЛИ значений флагов, которые указывают следующее:

• Уровень событий для записи журнала. Уровни событий, которые можно указать для записи журнала, совпадают с уровнями, которые можно включить для текстового журнала. Список флагов уровня событий см. в разделе Настройка уровня событий для текстового журнала SetupAPI.
• Указывает, следует ли включать метку времени в запись журнала. Значение флага метки времени TXTLOG_TIMESTAMP.
• Изменение (при наличии) глубины отступов раздела и текущей записи журнала. Сведения об использовании флагов отступов см. в разделе Запись записей журнала с отступами.

[in] InfHandle

Дескриптор INF-файла, содержащий строку текста, записываемую в текстовый журнал. Дескриптор INF-файла получается путем вызова SetupOpenInfFile, который описан в пакете SDK для платформы.

[in] Context

Указатель на контекст INF-файла, указывающий строку текста, записываемую в текстовый журнал. Контекст INF-файла для строки получается путем вызова функций SetupFindXxxLine . Сведения о INF-файлах и контексте INF-файла см. в разделе в разделе Sdk для платформы сведения об использовании INF-файлов, получении контекста INF-файла и структуре INFCONTEXT.

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

None

Remarks

SetupWriteTextLogInfLine записывает запись журнала в следующем формате:

entry-prefixtime-stampinf:indentationinf-line-text(inf-file-nameline-number)

Где:

• Поля префикса записи и метки времени совпадают с полями, описанными в разделе Формат текста раздела журнала текста.
• Поле inf-line-text содержит текст указанной строки INF-файла.
• Поле inf-file-name содержит имя INF-файла , содержащего указанную строку INF-файла.
• Поле номер строки содержит номер строки указанной строки в INF-файле .

Маркер журнала и флаги, которые предоставляет вызывающий объект, влияют на работу SetupWriteTextLogInfLine так же, как описано для SetupWriteTextLog и SetupWriteTextLogError. Кроме того, SetupWriteTextLogInfLine использует категорию событий TXTLOG_INF.

Общие сведения о записи записей журнала в текстовых журналах setupAPI см. в разделе Ведение журнала SetupAPI (Windows Vista).

Дополнительные сведения об операции SetupWriteTextLogInfLine см. в разделе Вызов SetupWriteTextLogInfLine.

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

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	setupapi.h (включая Setupapi.h)
Библиотека	Setupapi.lib
DLL	Setupapi.dll

См. также раздел

SetupGetThreadLogToken

SetupWriteTextLog

SetupWriteTextLogError