テキスト ログのイベント レベルの設定
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 に設定します。 |