Função AbortSystemShutdownA (winreg.h)
Interrompe um desligamento do sistema que foi iniciado.
Sintaxe
BOOL AbortSystemShutdownA(
[in, optional] LPSTR lpMachineName
);
Parâmetros
[in, optional] lpMachineName
O nome da rede do computador em que o desligamento deve ser interrompido. Se lpMachineName estiver NULL ou uma cadeia de caracteres vazia, a função interromperá o desligamento no computador local.
Valor de retorno
Se a função for bem-sucedida, o valor retornado não será zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Observações
As funções InitiateSystemShutdown e InitiateSystemShutdownEx exibem uma caixa de diálogo que notifica o usuário de que o sistema está sendo desligado. Durante o período de tempo limite de desligamento, a função AbortSystemShutdown pode impedir que o sistema seja desligado.
Windows Server 2003 e Windows XP com SP1: Se o computador a ser desligado for um servidor dos Serviços de Terminal, o sistema exibirá uma caixa de diálogo para todos os usuários locais e remotos avisando que o desligamento foi iniciado. Se o desligamento for impedido por AbortSystemShutdown, o sistema exibirá a caixa de diálogo para os usuários informando que o servidor não está mais sendo desligado.
Para impedir que o computador local seja desligado, o processo de chamada deve ter o privilégio SE_SHUTDOWN_NAME. Para impedir que um computador remoto seja desligado, o processo de chamada deve ter o privilégio SE_REMOTE_SHUTDOWN_NAME no computador remoto. Por padrão, os usuários podem habilitar o privilégio de SE_SHUTDOWN_NAME no computador no qual estão conectados e os administradores podem habilitar o privilégio SE_REMOTE_SHUTDOWN_NAME em computadores remotos. Para obter mais informações, consulte Em execução com privilégios especiais.
Os motivos comuns de falha incluem um nome de computador inválido, um computador inacessível ou privilégio insuficiente.
Exemplos
Para obter um exemplo, consulte Exibindo a caixa de diálogo Desligamento.
Nota
O cabeçalho winreg.h define AbortSystemShutdown como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [aplicativos da área de trabalho | Aplicativos UWP] |
| servidor com suporte mínimo | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winreg.h (inclua Windows.h) |
| biblioteca | Advapi32.lib |
| de DLL |
Advapi32.dll |