啟用文字記錄的事件類別

只有當文字記錄的事件類別已啟用，且文字記錄的事件層級等於或大於記錄項目的事件層級時，SetupAPI 才會在文字記錄中寫入記錄項目。

下表列出 SetupAPI 支援的事件類別目錄、代表事件類別目錄的指令清單常數，以及指令清單常數的值。

事件類別操作	事件類別顯示常數	事件類別值
裝置安裝	TXTLOG_DEVINST	0x00000001
管理 INF 檔案	TXTLOG_INF	0x00000002
管理檔案佇列	TXTLOG_FILEQ	0x00000004
複製檔案	TXTLOG_複製文件	0x00000008
管理登錄設定	TXTLOG_REGISTRY	0x00000010
驗證數字簽名	TXTLOG_SIGVERIF	0x00000020
管理裝置和驅動程序屬性	TXTLOG_PROPERTIES	0x00000040
備份資料	文字日志備份	0x00000080
管理使用者介面對話框	TXTLOG_UI	0x00000100
新的設備管理員	TXTLOG_NEWDEV	0x01000000
使用者模式 PnP 管理員	TXTLOG_UMPNPMGR	0x02000000
管理驅動程式存放區	TXTLOG_驅動程式存儲	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 登錄值會格式化為 0X VVVVVVVVVV，其中 VVVVVVVV 是 32 位字段。 若要啟用所有類別，請將 LogMask 設定為 0XFFFFFFFF。 若要只啟用特定類別，請對對應的事件類別常數執行位元 OR。 例如：

• 若要只啟用裝置安裝作業所寫入的記錄專案，請將 LogMask 設定為 TXTLOG_DEVINST 的值 （0X00000001）

• 若要只啟用裝置安裝作業和驅動程式存放區作業所寫入的記錄專案，請將 LogMask 設定為 （TTXTLOG_DRIVER_STORE |TEXTLOG_DEVINST）（0x04000001）。

• 若要只啟用自定義安裝作業所寫入的記錄專案，請將 LogMask 設定為 TXTLOG_VENDOR（0x80000000）。