设置文本日志的事件级别
仅当为文本日志设置的事件级别大于或等于日志条目的事件级别,并且为文本日志启用日志条目的事件类别时,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 注册表值不存在或值为零,则 SetupAPI 将应用程序安装和设备安装文本日志的事件级别设置为下表中所述的默认值:
文本日志 | 默认值 (Windows 7 及更高版本) | Windows Vista SP2) (默认值 | 默认值 (Windows Vista SP1 和早期版本) |
---|---|---|---|
应用程序安装文本日志 (SetupAPI.app.log) |
TXTLOG_SUMMARY |
TXTLOG_WARNING |
TXTLOG_DETAILS |
设备安装文本日志 (安装程序API.dev.log) |
TXTLOG_DETAILS |
TXTLOG_DETAILS |
TXTLOG_DETAILS |
有关这些文本日志文件的详细信息,请参阅 安装程序API 文本日志。
LogLevel 注册表值的格式设置为 0xUUUUGHVW,其中:
VW 0x000000掩码表示的低位八位指定是否为应用程序安装日志启用日志记录,并为应用程序日志指定事件级别。
由掩码 0x0000GH00 表示的下一个最高 8 位指定是否为设备安装文本日志启用日志记录,并为设备安装文本日志指定事件级别。
不使用掩码 0xUUU0000 表示的最高级别位。
0xVW 位的值控制应用程序安装日志的日志记录,如下表所示。
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。 |