System herunterfahren von Ursachencodes

Die Herunterfahren-Grundcodes werden von den Funktionen ExitWindowsEx und InitiateSystemShutdownEx im dwReason-Parameter verwendet.

Vom System werden maximal MAX_NUM_REASONS Grundcodes verarbeitet. MAX_NUM_REASONS wird in "reason.h" definiert.

Im Folgenden sind die Hauptgründe für Flags aufgeführt. Sie geben den allgemeinen Problemtyp an.

Konstante/Wert BESCHREIBUNG
SHTDN_REASON_MAJOR_APPLICATION
0x00040000
Anwendungsproblem.
SHTDN_REASON_MAJOR_HARDWARE
0x00010000
Hardwareproblem.
SHTDN_REASON_MAJOR_LEGACY_API
0x00070000
Die InitiateSystemShutdown-Funktion wurde anstelle von InitiateSystemShutdownEx verwendet.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM
0x00020000
Betriebssystemproblem.
SHTDN_REASON_MAJOR_OTHER
0x00000000
Anderes Problem.
SHTDN_REASON_MAJOR_POWER
0x00060000
Stromausfall.
SHTDN_REASON_MAJOR_SOFTWARE
0x00030000
Softwareproblem.
SHTDN_REASON_MAJOR_SYSTEM
0x00050000
Systemfehler.

Im Folgenden sind die Nebengründe flags aufgeführt. Sie ändern das angegebene Hauptgrundzeichen. Sie können jeden geringfügigen Grund in Verbindung mit irgendeinem Hauptgrund verwenden, aber einige Kombinationen sind nicht sinnvoll.

Konstante/Wert BESCHREIBUNG
SHTDN_REASON_MINOR_BLUESCREEN
0x0000000F
Absturzereignis auf blauer Bildschirm.
SHTDN_REASON_MINOR_CORDUNPLUGGED
0x0000000b
Unplugged.
SHTDN_REASON_MINOR_DISK
0x00000007
auswählen.
SHTDN_REASON_MINOR_ENVIRONMENT
0x0000000c
Umgebung.
SHTDN_REASON_MINOR_HARDWARE_DRIVER
0x0000000d
Treiber.
SHTDN_REASON_MINOR_HOTFIX
0x00000011
Hot Fix.
SHTDN_REASON_MINOR_HOTFIX_UNINSTALL
0x00000017
Hot fix uninstallation.
SHTDN_REASON_MINOR_HUNG
0x00000005
Reagiert.
SHTDN_REASON_MINOR_INSTALLATION
0x00000002
Die Installation.
SHTDN_REASON_MINOR_MAINTENANCE
0x00000001
Wartung.
SHTDN_REASON_MINOR_MMC
0x00000019
MMC-Problem.
SHTDN_REASON_MINOR_NETWORK_CONNECTIVITY
0x00000014
Netzwerkkonnektivität
SHTDN_REASON_MINOR_NETWORKCARD
0x00000009
Netzwerkkarte.
SHTDN_REASON_MINOR_OTHER
0x00000000
Anderes Problem.
SHTDN_REASON_MINOR_OTHERDRIVER
0x0000000e
Anderes Treiberereignis.
SHTDN_REASON_MINOR_POWER_SUPPLY
0x0000000a
Stromversorgung.
SHTDN_REASON_MINOR_PROCESSOR
0x00000008
Prozessor
SHTDN_REASON_MINOR_RECONFIG
0x00000004
Konfigurieren.
SHTDN_REASON_MINOR_SECURITY
0x00000013
Sicherheitsproblem.
SHTDN_REASON_MINOR_SECURITYFIX
0x00000012
Sicherheitspatch.
SHTDN_REASON_MINOR_SECURITYFIX_UNINSTALL
0x00000018
Deinstallation des Sicherheitspatches.
SHTDN_REASON_MINOR_SERVICEPACK
0x00000010
Service Pack.
SHTDN_REASON_MINOR_SERVICEPACK_UNINSTALL
0x00000016
Deinstallation von Service Pack.
SHTDN_REASON_MINOR_TERMSRV
0x00000020
Terminaldienste.
SHTDN_REASON_MINOR_UNSTABLE
0x00000006
Instabil.
SHTDN_REASON_MINOR_UPGRADE
0x00000003
Upgrade:
SHTDN_REASON_MINOR_WMI
0x00000015
WMI-Problem.

Die folgenden optionalen Flags enthalten zusätzliche Informationen zum Ereignis.

Konstante/Wert BESCHREIBUNG
SHTDN_REASON_FLAG_USER_DEFINED
0x40000000
Der Grundcode wird vom Benutzer definiert. Weitere Informationen finden Sie unter Definieren eines benutzerdefinierten Grundcodes.
Wenn dieses Kennzeichen nicht vorhanden ist, wird der Grundcode vom System definiert.
SHTDN_REASON_FLAG_PLANNED
0x80000000
Das Herunterfahren wurde geplant. Das System generiert eine SSD-Datei (System State Data). Diese Datei enthält Systemstatusinformationen wie Prozesse, Threads, Speichernutzung und Konfiguration.
Wenn dieses Kennzeichen nicht vorhanden ist, wurde das Herunterfahren nicht geplant. Benachrichtigungs- und Berichtsoptionen werden durch eine Reihe von Richtlinien gesteuert. Nach der Anmeldung zeigt das System beispielsweise ein Dialogfeld an, in dem das nicht geplante Herunterfahren gemeldet wird, wenn die Richtlinie aktiviert wurde. Eine SSD-Datei wird nur erstellt, wenn die SSD-Richtlinie auf dem System aktiviert ist. Der Administrator kann Windows-Fehlerberichterstattung verwenden, um die SSD-Daten an einen zentralen Ort oder an Microsoft zu senden.

Bemerkungen

Die folgenden Kombinationen werden vom System erkannt. Die Tabelle gibt die Zeichenfolge an, die im Shutdown Event Tracker angezeigt wird, und enthält eine ausführlichere Beschreibung. Die Standardzeichenfolge lautet "Aus diesem Grund konnte kein Titel gefunden werden."

Kombination BESCHREIBUNG
SHTDN_REASON_MAJOR_APPLICATION | SHTDN_REASON_MINOR_HUNG "Anwendung: Nicht reagierend" Ein nicht geplanter Neustart oder Herunterfahren, um eine nicht reagierende Anwendung zu beheben.
SHTDN_REASON_MAJOR_APPLICATION | SHTDN_REASON_MINOR_INSTALLATION | SHTDN_REASON_FLAG_PLANNED "Anwendung: Installation (Geplant)" Ein geplanter Neustart oder Herunterfahren zur Ausführung der Anwendungsinstallation.
SHTDN_REASON_MAJOR_APPLICATION | SHTDN_REASON_MINOR_MAINTENANCE "Anwendung: Wartung (nicht geplant)" Ein nicht geplanter Neustart oder Herunterfahren, um eine Anwendung zu verwenden.
SHTDN_REASON_MAJOR_APPLICATION | SHTDN_REASON_MINOR_MAINTENANCE | SHTDN_REASON_FLAG_PLANNED "Anwendung: Wartung (Geplant)" Ein geplanter Neustart oder Herunterfahren zur Durchführung geplanter Wartung auf einer Anwendung.
SHTDN_REASON_MAJOR_APPLICATION | SHTDN_REASON_MINOR_UNSTABLE "Anwendung: Instabil" Ein nicht geplanter Neustart oder Herunterfahren, um eine instabile Anwendung zu beheben.
SHTDN_REASON_MAJOR_HARDWARE | SHTDN_REASON_MINOR_INSTALLATION "Hardware: Installation (Nicht geplant)" Ein nicht geplanter Neustart oder Herunterfahren zum Starten oder Abschließen der Hardwareinstallation.
SHTDN_REASON_MAJOR_HARDWARE | SHTDN_REASON_MINOR_INSTALLATION | SHTDN_REASON_FLAG_PLANNED "Hardware: Installation (Geplant)" Ein geplanter Neustart oder Herunterfahren, um die Hardwareinstallation zu starten oder abzuschließen.
SHTDN_REASON_MAJOR_HARDWARE | SHTDN_REASON_MINOR_MAINTENANCE "Hardware: Wartung (nicht geplant)" Ein nicht geplanter Neustart oder Herunterfahren an Diensthardware auf dem System.
SHTDN_REASON_MAJOR_HARDWARE | SHTDN_REASON_MINOR_MAINTENANCE | SHTDN_REASON_FLAG_PLANNED "Hardware: Wartung (Geplant)" Ein geplanter Neustart oder Herunterfahren auf Diensthardware auf dem System.
SHTDN_REASON_MAJOR_LEGACY_API "Legacy-API-Herunterfahren" Dieses Herunterfahren wurde von der Legacy-Funktion "InitiateSystemShutdown " initiiert. Anwendungen sollten die InitiateSystemShutdownEx-Funktion verwenden.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_HOTFIX "Betriebssystem: Hot Fix (Unplanned)" Ein nicht geplanter Neustart oder Herunterfahren, um einen Hot Fix zu installieren.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_HOTFIX | SHTDN_REASON_FLAG_PLANNED "Betriebssystem: Hot Fix (Geplant)" Ein geplanter Neustart oder Herunterfahren, um einen Hot Fix zu installieren.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_RECONFIG "Betriebssystem: Neukonfiguration (nicht geplant)" Ein nicht geplanter Neustart oder Herunterfahren, um die Betriebssystemkonfiguration zu ändern.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_RECONFIG | SHTDN_REASON_FLAG_PLANNED "Betriebssystem: Neukonfiguration (Geplant)" Ein geplanter Neustart oder Herunterfahren, um die Betriebssystemkonfiguration zu ändern.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_SECURITYFIX "Betriebssystem: Sicherheitskorrektur (nicht geplant)" Ein nicht geplanter Neustart oder Herunterfahren, um einen Sicherheitspatch zu installieren.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_SECURITYFIX | SHTDN_REASON_FLAG_PLANNED "Betriebssystem: Sicherheitskorrektur (Geplant)" Ein geplanter Neustart oder Herunterfahren, um einen Sicherheitspatch zu installieren.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_SERVICEPACK | SHTDN_REASON_FLAG_PLANNED "Betriebssystem: Service Pack (Geplant)" Ein geplanter Neustart oder Herunterfahren, um ein Service Pack zu installieren.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_UPGRADE | SHTDN_REASON_FLAG_PLANNED "Betriebssystem: Upgrade (Geplant)" Ein geplanter Neustart oder herunterfahren, um die Betriebssystemkonfiguration zu aktualisieren.
SHTDN_REASON_MAJOR_OTHER | SHTDN_REASON_MINOR_OTHER "Andere (nicht geplant)" Ein nicht geplantes Herunterfahren oder Neustart.
SHTDN_REASON_MAJOR_OTHER | SHTDN_REASON_MINOR_OTHER | SHTDN_REASON_FLAG_PLANNED "Sonstige (Geplant)" Ein geplantes Herunterfahren oder Neustart.
SHTDN_REASON_MAJOR_OTHER | SHTDN_REASON_MINOR_HUNG "Anderer Fehler: System unresponsiv" Das System reagierte nicht mehr.
SHTDN_REASON_MAJOR_POWER | SHTDN_REASON_MINOR_CORDUNPLUGGED "Stromausfall: Kabel nicht angeschlossen" Der Computer wurde nicht angeschlossen.
SHTDN_REASON_MAJOR_POWER | SHTDN_REASON_MINOR_ENVIRONMENT "Stromausfall: Umgebung" Es gab einen Stromausfall.
SHTDN_REASON_MAJOR_SYSTEM | SHTDN_REASON_MINOR_BLUESCREEN "Systemfehler: Stoppfehler" Der Computer hat ein Absturzereignis auf blauem Bildschirm angezeigt.
SHTDN_REASON_MAJOR_SYSTEM | SHTDN_REASON_MINOR_NETWORK_CONNECTIVITY "Verlust der Netzwerkkonnektivität (nicht geplant)" Der Computer muss aufgrund eines Netzwerkkonnektivitätsproblems heruntergefahren werden.
SHTDN_REASON_MAJOR_SYSTEM | SHTDN_REASON_MINOR_SECURITY "Sicherheitsproblem" Der Computer muss aufgrund eines Sicherheitsproblems heruntergefahren werden.

 

Sie können auch Eigene Herunterfahren-Gründe definieren und der Registrierung hinzufügen. Jeder Grundcode sollte als Registrierungswert im folgenden Schlüssel gespeichert werden:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Reliability\UserDefined\default_system_language_ID <>

Dieser Schlüssel enthält Wertnamen des folgenden Formulars: xxxxx; nnn; nnnnn. Die Semikolons trennen die Komponenten eines Wertnamens.

Xxxxx

Ein bis fünf der folgenden Steuerelementkennzeichnungen (keine anderen Zeichen können verwendet werden).

Flag Beschreibung
P Geplantes Herunterfahren; andernfalls wird ein nicht geplantes Herunterfahren beendet.
C Ein Kommentar ist erforderlich. Dieses Kennzeichen muss mit S verwendet werden.
B Eine ID ist erforderlich. Dieses Kennzeichen muss mit D verwendet werden.
E Zeigt das erwartete Herunterfahren an. Entweder S, D oder beide S und D müssen verwendet werden.
D Zeigt das unerwartete Herunterfahren an. Entweder S, D oder beide S und D müssen verwendet werden.

 

Die Reihenfolge, in der die Flags verwendet werden, ist nicht wichtig. Beispielsweise gibt CSP ein geplantes Herunterfahren an, in dem das erwartete Herunterfahren-Dialogfeld angezeigt wird, und ein Kommentar ist erforderlich.

Nnn

Hauptgrund. Diese Komponente muss eine Zahl im Bereich 64-255 sein. Der Bereich 0-63 ist für die Verwendung durch das System reserviert.

Nnnnn

Geringfügiger Grund. Diese Komponente muss sich im Bereich 0-65535 befinden.

Benutzerdefinierte Gründe werden in der Benutzeroberfläche nach hauptgrundnummer sortiert, und dann nach Nebengrundnummer. Keine zwei benutzerdefinierten Gründe können dieselben Haupt- und Nebengründe verwenden, es sei denn, eine ist geplant und die andere ist nicht geplant. Andernfalls wird das System die erste Instanz verwenden und die anderen ignorieren.

Die Daten für jeden Registrierungswert sind zwei Zeichenfolgen, getrennt durch \n\r. Die erste Zeichenfolge ist eine Titelzeichenfolge, die im Dialogfeld "Herunterfahren" angezeigt und in das Ereignisprotokoll geschrieben wird. Die maximale Größe beträgt 64 Zeichen. Titelzeichenfolgen müssen eindeutig sein. Benutzerdefinierte Titel können nicht mit den vom System definierten Standardtiteln oder einem anderen benutzerdefinierten Titel übereinstimmen. Die zweite Zeichenfolge ist eine Beschreibungszeichenfolge, die im Dialogfeld "Herunterfahren" angezeigt werden soll; es ist optional. Die maximale Größe beträgt 256 Zeichen.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003 [Desktop-Apps | UWP-Apps]
Header
Reason.h