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. |