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 |
|---|---|
|
Vom System reservierter letzter Herunterfahrbereich. |
|
Bereich des letzten Herunterfahrens der Anwendung reserviert. |
|
Reservierter Bereich des Herunterfahrens der Anwendung "zwischen" |
|
Reservierter erster Herunterfahrbereich der Anwendung. |
|
System reservierter erster Herunterfahrbereich. |
Alle Prozesse beginnen auf heruntergefahrener Ebene 0x280.
[in] dwFlags
Dieser Parameter kann der folgende Wert sein.
| Wert | Bedeutung |
|---|---|
|
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 |