SetProcessShutdownParameters-Funktion (processthreadsapi.h)

Artikel
08/25/2023

Legt Die Parameter für das Herunterfahren für den derzeit aufrufenden Prozess fest. Diese Funktion legt eine Reihenfolge des Herunterfahrens für einen Prozess relativ zu den anderen Prozessen im System fest.

Syntax

BOOL SetProcessShutdownParameters(
  [in] DWORD dwLevel,
  [in] DWORD dwFlags
);

Parameter

[in] dwLevel

Die Shutdown-Priorität für einen Prozess relativ zu anderen Prozessen im System. Das System fährt Prozesse von hohen dwLevel-Werten auf niedrig herunter. Die höchsten und niedrigsten Herunterfahrprioritäten sind für Systemkomponenten reserviert. Dieser Parameter muss im folgenden Wertebereich liegen.

Wert	Bedeutung
000-0FF	Vom System reservierter letzter Herunterfahrbereich.
100-1FF	Bereich des letzten Herunterfahrens der Anwendung reserviert.
200-2FF	Reservierter Bereich des Herunterfahrens der Anwendung "zwischen"
300-3FF	Reservierter erster Herunterfahrbereich der Anwendung.
400-4FF	System reservierter erster Herunterfahrbereich.

Alle Prozesse beginnen auf heruntergefahrener Ebene 0x280.

[in] dwFlags

Dieser Parameter kann der folgende Wert sein.

Wert	Bedeutung
SHUTDOWN_NORETRY 0x00000001	Das System beendet den Prozess, ohne ein Wiederholungsdialogfeld für den Benutzer anzuzeigen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Anwendungen, die im Systemsicherheitskontext ausgeführt werden, werden vom Betriebssystem nicht heruntergefahren. Sie werden über das Herunterfahren oder Abmelden über die Rückruffunktion benachrichtigt, die über SetConsoleCtrlHandler installiert werden kann. Sie werden auch in der vom dwLevel-Parameter angegebenen Reihenfolge benachrichtigt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	processthreadsapi.h (enthalten Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

GetProcessShutdownParameters

Prozess- und Threadfunktionen

Prozesse

SetConsoleCtrlHandler