テキスト ログのイベント カテゴリの有効化
SetupAPI は、ログ エントリのイベント カテゴリが、テキスト ログに対して有効になっており、テキスト ログのイベント レベルlがログ エントリのイベント レベル以上の場合にのみ、ログ エントリをテキスト ログに書き込みます。
次の表に、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 レジストリ値は、0XVVVVVVVV (VVVVVVVV が 32 ビットフィールドである場合) として書式設定されます。 すべてのカテゴリーを有効にするには、LogMask を 0XFFFFFFFF に設定します。 特定のカテゴリーのみを有効にするには、対応するイベント カテゴリー定数のビットごとの OR を実行します。 次に例を示します。
デバイスのインストール操作によって書き込まれるログ エントリのみを有効にするには、LogMask を TXTLOG_DEVINST (0X00000001) の値に設定します
デバイスのインストール操作とドライバー ストア操作によって書き込まれたログ エントリのみを有効にするには、LogMask を (TTXTLOG_DRIVER_STORE |TEXTLOG_DEVINST) (0x04000001) に設定します。
カスタム インストール操作によって書き込まれたログ エントリのみを有効にするには、LogMask を TXTLOG_VENDOR (0x80000000) に設定します。