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.