Função SetProcessShutdownParameters (processthreadsapi.h)
Define parâmetros de desligamento para o processo de chamada no momento. Essa função define uma ordem de desligamento para um processo relativo aos outros processos no sistema.
Sintaxe
BOOL SetProcessShutdownParameters(
[in] DWORD dwLevel,
[in] DWORD dwFlags
);
Parâmetros
[in] dwLevel
A prioridade de desligamento de um processo relativo a outros processos no sistema. O sistema desliga os processos de valores de dwLevel altos para baixo. As prioridades de desligamento mais altas e mais baixas são reservadas para componentes do sistema. Esse parâmetro deve estar no intervalo de valores a seguir.
| Valor | Significado |
|---|---|
|
Último intervalo de desligamento reservado do sistema. |
|
Último intervalo de desligamento reservado do aplicativo. |
|
Intervalo de desligamento "entre" reservado pelo aplicativo. |
|
Primeiro intervalo de desligamento reservado do aplicativo. |
|
Primeiro intervalo de desligamento reservado do sistema. |
Todos os processos começam no nível de desligamento 0x280.
[in] dwFlags
Esse parâmetro pode ser o valor a seguir.
| Valor | Significado |
|---|---|
|
O sistema encerra o processo sem exibir uma caixa de diálogo de repetição para o usuário. |
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Os aplicativos em execução no contexto de segurança do sistema não são desligados pelo sistema operacional. Eles são notificados de desligamento ou logoff por meio da função de retorno de chamada instalável por meio de SetConsoleCtrlHandler. Eles também são notificados na ordem especificada pelo parâmetro dwLevel .
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | processthreadsapi.h (inclua Windows.h no Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |