Festlegen der Ereignisebene für ein Textprotokoll

SetupAPI schreibt einen Protokolleintrag nur dann in ein Textprotokoll, wenn die für ein Textprotokoll festgelegte Ereignisebene größer oder gleich der Ereignisebene für den Protokolleintrag ist und die Ereigniskategorie für den Protokolleintrag für das Textprotokoll aktiviert ist.

In der folgenden Tabelle sind die von SetupAPI unterstützten Ereignisebenen und die Manifestkonstanten aufgeführt, die diese Ereignisebenen darstellen. TXTLOG_ERROR ist die niedrigste Ereignisebene, gefolgt von der nächsthöheren Ereignisebene TXTLOG_WARNING usw. TXTLOG_VERY_VERBOSE ist die höchste Ereignisebene.

Ereignisebene	Manifestkonstante auf Ereignisebene	Manifestwert auf Ereignisebene
Nur Schreibfehler.	TXTLOG_ERROR	1
Schreibfehler und Warnungen zu potenziellen Problemen.	TXTLOG_WARNING	2
Schreibfehler, Warnungen und Systemstatusänderungen.	TXTLOG_SYSTEM_STATE_CHANGE	3
Schreibfehler, Warnungen, Systemstatusänderungen und allgemeine Vorgänge, die zustandsänderungen zugeordnet sind.	TXTLOG_SUMMARY	4
Schreibfehler, Warnungen, Systemstatusänderungen, allgemeine Vorgänge, die mit Zustandsänderungen verknüpft sind, und die meisten Betriebsdetails.	TXTLOG_DETAILS	5
Schreibfehler, Warnungen, Systemstatusänderungen, allgemeine Vorgänge, die mit Zustandsänderungen verknüpft sind, und alle Betriebsdetails.	TXTLOG_VERBOSE	6
Schreiben Sie alle Protokolleinträge, einschließlich der Einträge, die möglicherweise eine große Menge an Informationen generieren, die häufig überflüssig sind.	TXTLOG_VERY_VERBOSE	7

Um die Ereignisebene für die SetupAPI-Textprotokolle festzulegen, erstellen (oder ändern) Sie den folgenden REG_DWORD Registrierungswert:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogLevel

Wenn der Registrierungswert LogLevel nicht vorhanden ist oder den Wert 0 aufweist, legt SetupAPI die Ereignisebene für die Anwendungsinstallations- und Geräteinstallationstextprotokolle auf die in der folgenden Tabelle beschriebenen Standardwerte fest:

Textprotokoll	Standardwert (Windows 7 und höhere Versionen)	Standardwert (Windows Vista SP2)	Standardwert (Windows Vista SP1 und frühere Versionen)
Textprotokoll zur Anwendungsinstallation (SetupAPI.app.log)	TXTLOG_SUMMARY	TXTLOG_WARNING	TXTLOG_DETAILS
Textprotokoll zur Geräteinstallation (SetupAPI.dev.log)	TXTLOG_DETAILS	TXTLOG_DETAILS	TXTLOG_DETAILS

Weitere Informationen zu diesen Textdateien finden Sie unter SetupAPI-Textprotokolle.

Der LogLevel-Registrierungswert ist als 0xUUUUGHVW formatiert, wobei Folgendes gilt:

• Die acht Bits mit niedriger Reihenfolge, die durch die Maske 0x000000VW dargestellt werden, geben an, ob die Protokollierung für das Anwendungsinstallationsprotokoll aktiviert ist, und geben die Ereignisebene für das Anwendungsprotokoll an.

• Die nächsthöchsten acht Bits, die durch die Maske 0x0000GH00 dargestellt werden, geben an, ob die Protokollierung für das Geräteinstallationstextprotokoll aktiviert ist, und geben die Ereignisebene für das Geräteinstallationstextprotokoll an.

• Die Bits der höchsten Ebene, die durch die Maske 0xUUUU0000 dargestellt werden, werden nicht verwendet.

Der Wert der 0xVW-Bits steuert die Protokollierung für das Anwendungsinstallationsprotokoll, wie in der folgenden Tabelle gezeigt.

0xVW-Wert	BESCHREIBUNG
Null (Standard)	Die Protokollierung ist aktiviert, und die Ereignisebene wird auf den Standardwert festgelegt, wie zuvor beschrieben.
0x01 bis 0x0F	Deaktiviert die Protokollierung.
0x10 bis 0x7F	Aktiviert die Protokollierung und legt die Ereignisebene auf 0xV fest.

Der Wert der 0xGH-Bits steuert die Protokollierung für das Geräteinstallationstextprotokoll, wie in der folgenden Tabelle gezeigt.

0xGH-Wert	BESCHREIBUNG
Null (Standard)	Die Protokollierung ist aktiviert, und die Ereignisebene wird auf den Standardwert festgelegt, wie zuvor beschrieben.
0x01 bis 0x0F	Deaktiviert die Protokollierung.
0x10 bis 0x7F	Aktiviert die Protokollierung und legt die Ereignisebene auf 0xG fest.

Die folgende Tabelle enthält Beispiele für typische LogLevel-Werte .

LogLevel-Wert	Für die Textprotokolle festgelegte Ereignisebenen
0x00000000	Aktiviert standardmäßig die Protokollierung für das Anwendungsinstallationsprotokoll und das Geräteinstallationsprotokoll. Legt die Protokollierungsebene auf die Standardwerte für beide Protokolle fest.
0x00000101	Deaktiviert die Protokollierung sowohl für das Anwendungsinstallationsprotokoll als auch für das Geräteinstallationsprotokoll.
0x00001010	Aktiviert die Protokollierung für das Anwendungsinstallationsprotokoll und das Geräteinstallationsprotokoll. Legt die Protokollierungsebene für beide Protokolle auf TXTLOG_ERROR fest.
0x00002020	Aktiviert die Protokollierung für das Anwendungsinstallationsprotokoll und das Geräteinstallationsprotokoll. Legt die Protokollierungsebene für beide Protokolle auf TXTLOG_WARNING fest.
0x00005050	Aktiviert die Protokollierung für das Anwendungsinstallationsprotokoll und das Geräteinstallationsprotokoll. Legt die Protokollierungsebene für beide Protokolle auf TXTLOG_DETAILS fest.
0x00006060	Aktiviert die Protokollierung für das Anwendungsinstallationsprotokoll und das Geräteinstallationsprotokoll. Legt die Protokollierungsebene für beide Protokolle auf TXTLOG_VERBOSE fest.
0x00007070	Aktiviert die Protokollierung für das Anwendungsinstallationsprotokoll und das Geräteinstallationsprotokoll. Legt die Protokollierungsebene für beide Protokolle auf TXTLOG_VERY_VERBOSE fest.