|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| No
| Win32s
| No
| Import Library
| kernel32.lib
| Header File
| winbase.h
| Unicode
| No
| Platform Notes
| None
|
|
|
SetProcessShutdownParameters
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
GetProcessShutdownParameters, SetConsoleCtrlHandler
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|