GetProcessShutdownParameters

The GetProcessShutdownParameters function retrieves shutdown parameters for the currently calling process.

BOOL GetProcessShutdownParameters(
  LPDWORD lpdwLevel, // shutdown priority
  LPDWORD lpdwFlags  // shutdown flag
);

Parameters

lpdwLevel

[out] Pointer to a variable that receives the shutdown priority level. Higher levels shut down first. System level shutdown orders are reserved for system components. Higher numbers shut down first. Following are the level conventions.

Value	Meaning
000–0FF	System reserved last shutdown range.
100–1FF	Application reserved last shutdown range.
200–2FF	Application reserved "in between" shutdown range.
300–3FF	Application reserved first shutdown range.
400–4FF	System reserved first shutdown range.

All processes start at shutdown level 0x280.

lpdwFlags

[out] Pointer to a variable that receives the shutdown flags. This parameter can be the following value.

Value	Meaning
SHUTDOWN_NORETRY	If this process takes longer than the specified timeout to shut down, do not display a retry dialog box for the user. Instead, just cause the process to directly exit.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Unsupported.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Kernel32.lib.

See Also

Processes and Threads Overview, Process and Thread Functions, SetProcessShutdownParameters