Freigeben über


SetProcessShutdownParameters-Funktion (processthreadsapi.h)

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