Функция AbortSystemShutdownA (winreg.h)
Останавливает завершение работы системы, инициированное.
Синтаксис
BOOL AbortSystemShutdownA(
[in, optional] LPSTR lpMachineName
);
Параметры
[in, optional] lpMachineName
Сетевое имя компьютера, в котором будет остановлено завершение работы. Если lpMachineNameNULL или пустая строка, функция останавливает завершение работы на локальном компьютере.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение ненулевое.
Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Функции InitiateSystemShutdown и InitiateSystemShutdownEx отображают диалоговое окно, которое уведомляет пользователя о завершении работы системы. В течение периода ожидания завершения работы функция abortSystemShutdown может предотвратить завершение работы системы.
Windows Server 2003 и Windows XP с пакетом обновления 1 (SP1): Если компьютер должен быть выключен сервером служб терминалов, система отображает диалоговое окно для всех локальных и удаленных пользователей, предупреждающих о завершении работы. Если завершение работы предотвращается AbortSystemShutdown, система отображает диалоговое окно для пользователей, информирующих о том, что сервер больше не завершает работу.
Чтобы остановить завершение работы локального компьютера, вызов должен иметь права SE_SHUTDOWN_NAME. Чтобы остановить завершение работы удаленного компьютера, вызывающий процесс должен иметь права SE_REMOTE_SHUTDOWN_NAME на удаленном компьютере. По умолчанию пользователи могут включить права SE_SHUTDOWN_NAME на компьютере, на который они вошли, и администраторы могут включить SE_REMOTE_SHUTDOWN_NAME привилегии на удаленных компьютерах. Дополнительные сведения см. в разделе Выполнение с специальными привилегиями.
Распространенные причины сбоя включают недопустимое имя компьютера, недоступный компьютер или недостаточно привилегий.
Примеры
Пример см. в разделе Отображение диалогового окна завершения работы.
Заметка
Заголовок winreg.h определяет AbortSystemShutdown как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows XP [классические приложения | Приложения UWP] |
| минимальный поддерживаемый сервер | Windows Server 2003 [классические приложения | Приложения UWP] |
| целевая платформа | Виндоус |
| заголовка | winreg.h (включая Windows.h) |
| библиотеки |
Advapi32.lib |
| DLL | Advapi32.dll |