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 Ereignisebenen aufgeführt, die SetupAPI unterstützt, und die Manifestkonstanten, die diese Ereignisebenen darstellen. TXTLOG_ERROR ist die niedrigste Ereignisebene, gefolgt von der nächsten höchsten Ereignisebene TXTLOG_WARNING usw. TXTLOG_VERY_VERBOSE ist die höchste Ereignisebene.

Ereignisebene Manifestkonstante auf Ereignisebene Manifestwert auf Ereignisebene

Nur Fehler schreiben.

TXTLOG_ERROR

1

Fehler und Warnungen zu potenziellen Problemen schreiben.

TXTLOG_WARNING

2

Fehler, Warnungen und Systemstatusänderungen schreiben.

TXTLOG_SYSTEM_STATE_CHANGE

3

Fehler, Warnungen, Systemstatusänderungen und allgemeine Vorgänge schreiben, die mit Statusänderungen verknüpft sind.

TXTLOG_SUMMARY

4

Fehler, Warnungen, Systemstatusänderungen, allgemeine Vorgänge, die mit Statusänderungen verknüpft sind, und die meisten Vorgangsdetails schreiben.

TXTLOG_DETAILS

5

Fehler, Warnungen, Systemstatusänderungen, allgemeine Vorgänge, die mit Statusänderungen verknüpft sind, und alle Vorgangsdetails schreiben.

TXTLOG_VERBOSE

6

Alle Protokolleinträge schreiben, einschließlich derer, 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 einen Wert von Null hat, legt SetupAPI die Ereignisebene für die Anwendungsinstallation und Geräteinstallationstextprotokolle auf die Standardwerte fest, die in der folgenden Tabelle beschrieben sind:

Textprotokoll Standardwert (Windows 7 und höher) Standardwert (Windows Vista SP2) Standardwert (Windows Vista SP1 und frühere Versionen)

Textprotokoll der Anwendungsinstallation (SetupAPI.app.log)

TXTLOG_SUMMARY

TXTLOG_WARNING

TXTLOG_DETAILS

Textprotokoll für die Geräteinstallation (SetupAPI.dev.log)

TXTLOG_DETAILS

TXTLOG_DETAILS

TXTLOG_DETAILS

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

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

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

  • Die nächsten acht Bits, dargestellt durch die Maske 0x0000GH00, geben an, ob die Protokollierung für das Textprotokoll der Geräteinstallation aktiviert ist, und legen die Ereignisebene für das Textprotokoll der Geräteinstallation fest.

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

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

0xVW-Wert Description

Null (Standardwert)

Die Protokollierung ist aktiviert, und die Ereignisebene wird wie zuvor beschrieben auf den Standardwert festgelegt.

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 Textprotokoll für die Geräteinstallation, wie in der folgenden Tabelle dargestellt.

0xGH-Wert Description

Null (Standardwert)

Die Protokollierung ist aktiviert, und die Ereignisebene wird wie zuvor beschrieben auf den Standardwert festgelegt.

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 Ereignisstufen

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.