設定文字記錄的事件層級

只有在為文字記錄檔設定的事件層級大於或等於記錄專案的事件層級時，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
裝置安裝文字記錄 (SetupAPI.dev.log)	TXTLOG_DETAILS	TXTLOG_DETAILS	TXTLOG_DETAILS

如需這些文字記錄檔的詳細資訊，請參閱 SetupAPI 文字記錄。

LogLevel登錄值的格式為 0xUUUUGHVW，其中：

• 遮罩所代表的低序八位0x000000VW，指定是否開啟應用程式安裝記錄檔的記錄，並指定應用程式記錄的事件層級。

• 下一個最高八位，由遮罩0x0000GH00 表示，指定是否開啟裝置安裝文字記錄的記錄，並指定裝置安裝文字記錄的事件層級。

• 不會使用遮罩 0xUUU0000 表示的最高層級位。

0xVW 位的值會控制應用程式安裝記錄檔的記錄，如下表所示。

0xVW 值	描述
零 (預設)	記錄已開啟，事件層級會設定為預設值，如先前所述。
透過0x0F 0x01	關閉記錄。
透過 0x7F 0x10	開啟記錄，並將事件層級設定為 0xV。

0xGH 位的值控制裝置安裝文字記錄檔的記錄，如下表所示。

0xGH 值	描述
零 (預設)	記錄已開啟，事件層級會設定為預設值，如先前所述。
透過0x0F 0x01	關閉記錄。
透過 0x7F 0x10	開啟記錄，並將事件層級設定為 0xG。

下表提供一般 LogLevel 值的範例。

LogLevel 值	為文字記錄設定的事件層級
0x00000000	根據預設，開啟應用程式安裝記錄檔和裝置安裝記錄檔的登入。 將記錄層級設定為這兩個記錄的預設值。
0x00000101	關閉應用程式安裝記錄檔和裝置安裝記錄檔的記錄。
0x00001010	開啟應用程式安裝記錄檔和裝置安裝記錄檔的登入。 將記錄層級設定為兩個記錄TXTLOG_ERROR。
0x00002020	開啟應用程式安裝記錄檔和裝置安裝記錄檔的登入。 將這兩個記錄檔的記錄層級設定為TXTLOG_WARNING。
0x00005050	開啟應用程式安裝記錄檔和裝置安裝記錄檔的登入。 將這兩個記錄檔的記錄層級設定為TXTLOG_DETAILS。
0x00006060	開啟應用程式安裝記錄檔和裝置安裝記錄檔的登入。 將記錄層級設定為兩個記錄TXTLOG_VERBOSE。
0x00007070	開啟應用程式安裝記錄檔和裝置安裝記錄檔的登入。 將記錄層級設定為兩個記錄TXTLOG_VERY_VERBOSE。