启用文本日志的事件类别

仅当为文本日志启用日志条目的事件类别，并且文本日志 的事件级别 等于或大于该日志条目的事件级别时，SetupAPI 才会在文本日志中写入日志条目。

下表列出了 SetupAPI 支持的事件类别、表示事件类别的清单常量以及清单常量的值。

事件类别操作	事件类别清单常量	事件类别值
设备安装	TXTLOG_DEVINST	0x00000001
管理 INF 文件	TXTLOG_INF	0x00000002
管理文件队列	TXTLOG_FILEQ	0x00000004
复制文件	TXTLOG_COPYFILES	0x00000008
管理注册表设置	TXTLOG_REGISTRY	0x00000010
验证数字签名	TXTLOG_SIGVERIF	0x00000020
管理设备和驱动程序属性	TXTLOG_PROPERTIES	0x00000040
备份数据	TXTLOG_BACKUP	0x00000080
管理用户界面对话框	TXTLOG_UI	0x00000100
新建设备管理器	TXTLOG_NEWDEV	0x01000000
用户模式 PnP 管理器	TXTLOG_UMPNPMGR	0x02000000
管理驱动程序存储	TXTLOG_DRIVER_STORE	0x04000000
类安装程序或合作安装程序操作	TXTLOG_INSTALLER	0x40000000
供应商提供的操作	TXTLOG_VENDOR	0x80000000

若要为 SetupAPI 日志启用事件类别，请创建 (或修改) 以下 REG_DWORD 注册表值：
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogMask

LogMask 注册表值适用于设备安装文本日志和应用程序安装文本日志。

如果 LogMask 注册表值不存在，则 SetupAPI 将启用文本日志的所有事件类别。 如果 LogMask 注册表值为零，则 SetupAPI 将禁用文本日志的所有事件类别。

LogMask 注册表值的格式为 0XVVVVVVV，其中 VVVVVVVV 是 32 位域。 若要启用所有类别，请将 LogMask 设置为 0XFFFFFFFF。 若要仅启用特定类别，请对相应的事件类别常量执行按位 OR。 例如：

• 若要仅启用由设备安装操作写入的日志条目，请将 LogMask 的值设置为 TXTLOG_DEVINST (0X00000001)

• 若要仅启用由设备安装操作和驱动程序存储操作写入的日志条目，请将 LogMask 设置为 (TTXTLOG_DRIVER_STORE |TEXTLOG_DEVINST) (0x04000001) 。

• 若要仅启用由自定义安装操作写入的日志条目，请将 LogMask 设置为 TXTLOG_VENDOR (0x80000000) 。