Aktivieren von Ereigniskategorien für ein Textprotokoll
SetupAPI schreibt einen Protokolleintrag nur dann in ein Textprotokoll, wenn die Ereigniskategorie für den Protokolleintrag für das Textprotokoll aktiviert ist und die Ereignisebene für das Textprotokoll gleich oder größer als die Ereignisebene für den Protokolleintrag ist.
In der folgenden Tabelle sind die von SetupAPI unterstützten Ereigniskategorien, die Manifestkonstanten, die die Ereigniskategorien darstellen, und die Werte der Manifestkonstanten aufgeführt.
| Ereigniskategorievorgang | Manifestkonstante der Ereigniskategorie | Ereigniskategoriewert |
|---|---|---|
Geräteinstallation |
TXTLOG_DEVINST |
0x00000001 |
Verwalten von INF-Dateien |
TXTLOG_INF |
0x00000002 |
Verwalten von Dateiwarteschlangen |
TXTLOG_FILEQ |
0x00000004 |
Kopieren von Dateien |
TXTLOG_COPYFILES |
0x00000008 |
Verwalten von Registrierungseinstellungen |
TXTLOG_REGISTRY |
0x00000010 |
Überprüfen digitaler Signaturen |
TXTLOG_SIGVERIF |
0x00000020 |
Verwalten von Geräte- und Treibereigenschaften |
TXTLOG_PROPERTIES |
0x00000040 |
Sicherungsdaten |
TXTLOG_BACKUP |
0x00000080 |
Dialogfelder "Benutzeroberfläche verwalten" |
TXTLOG_UI |
0x00000100 |
Neuer Geräte-Manager |
TXTLOG_NEWDEV |
0x01000000 |
PnP-Manager im Benutzermodus |
TXTLOG_UMPNPMGR |
0x02000000 |
Verwalten des Treiberspeichers |
TXTLOG_DRIVER_STORE |
0x04000000 |
Klasseninstallationsprogramm oder Co-Installer-Betrieb |
TXTLOG_INSTALLER |
0x40000000 |
Vom Anbieter bereitgestellter Vorgang |
TXTLOG_VENDOR |
0x80000000 |
Um Ereigniskategorien für die SetupAPI-Protokolle zu aktivieren, erstellen (oder ändern) Sie den folgenden REG_DWORD Registrierungswert:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogMask
Der Registrierungswert LogMask gilt für das Textprotokoll für die Geräteinstallation und das Anwendungsinstallationstextprotokoll.
Wenn der Registrierungswert LogMask nicht vorhanden ist, aktiviert SetupAPI alle Ereigniskategorien für die Textprotokolle. Wenn der LogMask-Registrierungswert null ist, deaktiviert SetupAPI alle Ereigniskategorien für die Textprotokolle.
Der LogMask-Registrierungswert ist als 0XVVVVVVVVVV formatiert, wobei VVVVVVVV ein 32-Bit-Feld ist. Um alle Kategorien zu aktivieren, legen Sie LogMask auf 0XFFFFFFFF fest. Um nur bestimmte Kategorien zu aktivieren, führen Sie ein bitweises OR der entsprechenden Ereigniskategoriekonstanten aus. Beispiel:
Um nur Protokolleinträge zu aktivieren, die von Geräteinstallationsvorgängen geschrieben werden, legen Sie LogMask auf den Wert von TXTLOG_DEVINST (0X00000001) fest.
Um nur Protokolleinträge zu aktivieren, die von Geräteinstallationsvorgängen und Treiberspeichervorgängen geschrieben werden, legen Sie LogMask auf (TTXTLOG_DRIVER_STORE | TEXTLOG_DEVINST) (0x04000001).
Um nur Protokolleinträge zu aktivieren, die von benutzerdefinierten Installationsvorgängen geschrieben werden, legen Sie LogMask auf TXTLOG_VENDOR (0x80000000) fest.