The SetProcessShutdownParameters function sets shutdown parameters for the currently calling process. This function sets a shutdown order for a process relative to the other processes in the system.
BOOL SetProcessShutdownParameters(
| DWORD dwLevel, | // shutdown priority |
| DWORD dwFlags | // shutdown flags |
| ); |
Parameters
dwLevel
Specifies the shutdown priority for a process relative to other processes in the system. The system shuts down processes from high dwLevel values to low. The highest and lowest shutdown priorities are reserved for system components. This parameter must be in the following range of values:
| 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.
dwFlags
Specifies a flags parameter. It can be the following value:
| Value | Meaning |
| SHUTDOWN_NORETRY | Specifies whether to retry the shutdown if the specified time-out period expires. If this flag is specified, the system terminates the process without displaying a retry dialog box for the user. |
Return Values
If the function is succeeds, the return value is nonzero.
If the function fails, the return value is zero.
Remarks
Applications running in the system security context do not get shut down by the operating system. They get notified of shutdown or logoff through the callback function installable via SetConsoleCtrlHandler. They also get notified in the order specified by the dwLevel parameter.
See Also