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 for NULL ou uma cadeia de caracteres vazia, a função interromperá o desligamento no computador local.

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

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 SE_SHUTDOWN_NAME no computador em que estão conectados e os administradores podem habilitar o privilégio SE_REMOTE_SHUTDOWN_NAME em computadores remotos. Para obter mais informações, confira Executar com privilégios especiais.

Os motivos comuns para a 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.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	winreg.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll

Confira também

InitiateSystemShutdown

Desligar

Funções de desligamento do sistema