GetProcessShutdownParameters-Funktion (processthreadsapi.h)

  • Artikel

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