啟用文字記錄的事件類別目錄
只有在啟用文字記錄檔的事件類別目錄,且文字記錄檔的事件層級等於或大於記錄專案 的事件層級 時,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登錄值會格式化為 0XVVVVVVVVV,其中 VVVVVVVVVV 為32 位欄位。 若要啟用所有類別,請將 LogMask 設定為 0XFFFFFFFF。 若只要啟用特定類別,請執行對應事件類別目錄常數的位 OR。 例如:
若要只啟用裝置安裝作業所寫入的記錄專案,請將 LogMask 設定為 TXTLOG_DEVINST (0X00000001)
若要只啟用裝置安裝作業和驅動程式存放區作業所寫入的記錄專案,請將 LogMask 設定為 (TTXTLOG_DRIVER_STORE |TEXTLOG_DEVINST) (0x04000001) 。
若要只啟用自訂安裝作業所寫入的記錄專案,請將 LogMask 設定為 TXTLOG_VENDOR (0x80000000) 。