Настройка уровня событий для текстового журнала
SetupAPI записывает запись журнала в текстовый журнал, только если уровень событий, заданный для текстового журнала, больше или равен уровню событий для записи журнала, а категория событий для записи журнала включена для текстового журнала.
В следующей таблице перечислены уровни событий, поддерживаемые SetupAPI, и константы манифеста, представляющие эти уровни событий. TXTLOG_ERROR — это самый низкий уровень событий, за которым следует следующий самый высокий уровень событий TXTLOG_WARNING и т. д. TXTLOG_VERY_VERBOSE — это самый высокий уровень событий.
| Уровень события | Константы манифеста уровня событий | Значение манифеста уровня событий |
|---|---|---|
Только ошибки записи. |
TXTLOG_ERROR |
1 |
Запись ошибок и предупреждений о потенциальных проблемах. |
TXTLOG_WARNING |
2 |
Запись ошибок, предупреждений и изменений состояния системы. |
TXTLOG_SYSTEM_STATE_CHANGE |
3 |
Запись ошибок, предупреждений, изменений состояния системы и высокоуровневых операций, связанных с изменениями состояния. |
TXTLOG_SUMMARY |
4 |
Записывайте ошибки, предупреждения, изменения состояния системы, высокоуровневые операции, связанные с изменениями состояния, и большинство операционных сведений. |
TXTLOG_DETAILS |
5 |
Записывайте ошибки, предупреждения, изменения состояния системы, высокоуровневые операции, связанные с изменениями состояния, и все операционные сведения. |
TXTLOG_VERBOSE |
6 |
Запишите все записи журнала, в том числе те, которые могут генерировать большой объем информации, которая часто является лишней. |
TXTLOG_VERY_VERBOSE |
7 |
Чтобы задать уровень событий для текстовых журналов SetupAPI, создайте (или измените) следующее значение реестра REG_DWORD :
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogLevel
Если значение реестра LogLevel не существует или имеет нулевое значение, программа УстановкиAPI устанавливает уровень событий для текстовых журналов установки приложения и устройства в соответствии со значениями по умолчанию, описанными в следующей таблице.
| Текстовый журнал | Значение по умолчанию (Windows 7 и более поздние версии) | Значение по умолчанию (Windows Vista с пакетом обновления 2 (SP2) | Значение по умолчанию (Windows Vista с пакетом обновления 1 (SP1) и предыдущие версии) |
|---|---|---|---|
Текстовый журнал установки приложения (SetupAPI.app.log) |
TXTLOG_SUMMARY |
TXTLOG_WARNING |
TXTLOG_DETAILS |
Текстовый журнал установки устройства (SetupAPI.dev.log) |
TXTLOG_DETAILS |
TXTLOG_DETAILS |
TXTLOG_DETAILS |
Дополнительные сведения об этих текстовых файлах журналов см. в разделе Текстовые журналы SetupAPI.
Значение реестра LogLevel форматируется как 0xUUUUGHVW, где:
Восемь битов нижнего порядка, представленные маской 0x000000VW, указывают, включено ли ведение журнала установки приложения, и указывают уровень событий для журнала приложений.
Следующие восемь битов, представленные маской 0x0000GH00, указывают, включено ли ведение журнала для текстового журнала установки устройства, и укажите уровень событий для текстового журнала установки устройства.
Биты верхнего уровня, представленные маской 0xUUUU0000, не используются.
Значение 0xVW bits управляет ведением журнала установки приложения, как показано в следующей таблице.
| Значение 0xVW | Описание |
|---|---|
Ноль (по умолчанию) |
Ведение журнала включено, и для уровня событий устанавливается значение по умолчанию, как описано выше. |
0x01 по 0x0F |
Отключает ведение журнала. |
0x10 через 0x7F |
Включает ведение журнала и задает уровень события 0xV. |
Значение битов 0xGH управляет ведением журнала текста установки устройства, как показано в следующей таблице.
| Значение 0xGH | Описание |
|---|---|
Ноль (по умолчанию) |
Ведение журнала включено, и для уровня событий устанавливается значение по умолчанию, как описано выше. |
0x01 по 0x0F |
Отключает ведение журнала. |
0x10 через 0x7F |
Включает ведение журнала и задает уровень события 0xG. |
В следующей таблице приведены примеры типичных значений LogLevel .
| Значение LogLevel | Уровни событий, заданные для текстовых журналов |
|---|---|
0x00000000 |
По умолчанию включает ведение журнала установки приложений и журнала установки устройств. Устанавливает уровень ведения журнала в значения по умолчанию для обоих журналов. |
0x00000101 |
Отключает ведение журнала установки приложений и журнала установки устройств. |
0x00001010 |
Включает ведение журнала установки приложений и журнала установки устройств. Задает уровень ведения журнала TXTLOG_ERROR для обоих журналов. |
0x00002020 |
Включает ведение журнала установки приложений и журнала установки устройств. Задает уровень ведения журнала TXTLOG_WARNING для обоих журналов. |
0x00005050 |
Включает ведение журнала установки приложений и журнала установки устройств. Задает уровень ведения журнала TXTLOG_DETAILS для обоих журналов. |
0x00006060 |
Включает ведение журнала установки приложений и журнала установки устройств. Задает уровень ведения журнала TXTLOG_VERBOSE для обоих журналов. |
0x00007070 |
Включает ведение журнала установки приложений и журнала установки устройств. Задает уровень ведения журнала TXTLOG_VERY_VERBOSE для обоих журналов. |