Функция AbortSystemShutdownW (winreg.h)

Статья
08/27/2023

Останавливает инициированное завершение работы системы.

Синтаксис

BOOL AbortSystemShutdownW(
  [in, optional] LPWSTR lpMachineName
);

Параметры

[in, optional] lpMachineName

Сетевое имя компьютера, на котором должно быть остановлено завершение работы. Если lpMachineName имеет значение NULL или пустую строку, функция останавливает завершение работы на локальном компьютере.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав 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]
Целевая платформа	Windows
Header	winreg.h (включая Windows.h)
Библиотека	Advapi32.lib
DLL	Advapi32.dll

См. также раздел

InitiateSystemShutdown

Завершает работу

Функции завершения работы системы

Share via