SetProcessShutdownParameters

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.

Syntax

C++

BOOL WINAPI SetProcessShutdownParameters(  _In_ DWORD dwLevel,  _In_ DWORD dwFlags);

Parameters

dwLevel [in]

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.

ValueMeaning

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 [in]

This parameter can be the following value.

ValueMeaning

SHUTDOWN_NORETRY

0x00000001

The system terminates the process without displaying a retry dialog box for the user.

 

Return value

If the function is succeeds, the return value is nonzero.

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

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.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

WinBase.h on Windows XP, Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008, and Windows Server 2008 R2 (include Windows.h);

Processthreadsapi.h on Windows 8 and Windows Server 2012

Library

Kernel32.lib

DLL

Kernel32.dll