テキスト ログのイベント レベルの設定

SetupAPI は、テキスト ログ用に設定されたイベント レベルがログ エ ントリのイベント レベル以上であり、ログ エントリのイベント カテゴリがテキスト ログで有効になっている場合にのみ、ログ エントリをテキスト ログに書き込みます。

次の表に、SetupAPI でサポートされるイベント レベルと、これらのイベント レベルを表すマニフェスト定数を示します。 TXTLOG_ERROR は最も低いイベント レベルで、次に高いイベント レベル TXTLOG_WARNING などです。 TXTLOG_VERY_VERBO Standard Edition は最も高いイベント レベルです。

イベント レベル	イベント レベルのマニフェスト定数	イベント レベルのマニフェスト値
書き込みエラーのみ。	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 レジストリ値が存在しない場合、または値が 0 の場合、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 で表される下位 8 ビットは、アプリケーション インストール ログのログ記録を有効にするかどうかを指定し、アプリケーション ログのイベント レベルを指定します。

• マスク 0x0000 GH00 で表される次の最上位の 8 ビットは、デバイス インストール テキスト ログのログ記録を有効にするかどうかを指定し、デバイス インストール テキスト ログのイベント レベルを指定します。

• マスク 0xUUUU0000 で表される最上位ビットは使用されません。

0xVW ビットの値は、次の表に示すように、アプリケーション インストール ログのログ記録を制御します。

0xVW 値	説明
ゼロ (既定値)	ログ記録が有効になり、前に説明したようにイベント レベルが既定値に設定されます。
0x01 から 0x0F	ログ記録をオフにします。
0x10 から 0x7F	ログ記録をオンにし、イベント レベルを 0xV に設定します。

0xVW ビットの値は、次の表に示すように、デバイス インストール テキストのログ記録を制御します。

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 に設定します。