GetProcessShutdownParameters-Funktion (processthreadsapi.h)

Artikel
03/04/2024

Ruft die Herunterfahrparameter für den aktuell aufrufenden Prozess ab.

Syntax

BOOL GetProcessShutdownParameters(
  [out] LPDWORD lpdwLevel,
  [out] LPDWORD lpdwFlags
);

Parameter

[out] lpdwLevel

Ein Zeiger auf eine Variable, die die Prioritätsebene für das Herunterfahren empfängt. Höhere Ebenen werden zuerst heruntergefahren. Herunterfahren von Aufträgen auf Systemebene sind für Systemkomponenten reserviert. Höhere Zahlen werden zuerst heruntergefahren. Im Folgenden sind die Ebenenkonventionen aufgeführt.

Wert	Bedeutung
000-0FF	System reservierter letzter Herunterfahrbereich.
100-1FF	Bereich des letzten Herunterfahrens der Anwendung reserviert.
200-2FF	Für die Anwendung reservierter "Zwischen"-Herunterfahrbereich.
300-3FF	Der reservierte erste Herunterfahrbereich der Anwendung.
400-4FF	System reservierter erster Herunterfahrbereich.

Alle Prozesse beginnen mit der Herunterfahrebene 0x280.

[out] lpdwFlags

Ein Zeiger auf eine Variable, die die Shutdown-Flags empfängt. Dieser Parameter kann der folgende Wert sein.

Wert	Bedeutung
SHUTDOWN_NORETRY 0x00000001	Wenn das Herunterfahren dieses Prozesses länger dauert als das angegebene Timeout, wird kein Wiederholungsdialogfeld für den Benutzer angezeigt. Führen Sie stattdessen einfach dazu, dass der Prozess direkt beendet wird.

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.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	processthreadsapi.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Prozess- und Threadfunktionen

Prozesse

SetProcessShutdownParameters

Freigeben über