Функция NotifyBootConfigStatus (winsvc.h)

Статья
08/27/2023

Сообщает о состоянии загрузки диспетчеру управления службами. Он используется программами проверки загрузки. Эта функция может вызываться только процессом, запущенным в учетной записи LocalSystem или учетной записи администратора.

Синтаксис

BOOL NotifyBootConfigStatus(
  [in] BOOL BootAcceptable
);

Параметры

[in] BootAcceptable

Если значение равно TRUE, система сохраняет конфигурацию как последнюю известную хорошую конфигурацию. Если значение равно FALSE, система немедленно перезагружается, используя ранее сохраненную последнюю известную хорошую конфигурацию.

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

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

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

При возникновении ошибки возвращаемое значение равно нулю. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

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

Код возврата	Описание
ERROR_ACCESS_DENIED	У пользователя нет разрешений на выполнение этого действия. Это могут сделать только система и члены группы администраторов.

Сохранение конфигурации работающей системы с помощью этой функции является приемлемым методом сохранения последней известной хорошей конфигурации. Если конфигурация загрузки недопустима, используйте эту функцию, чтобы перезагрузить систему с помощью существующей последней известной хорошей конфигурации.

Для этого вызова функции маркер вызывающего объекта должен иметь разрешение на получение права доступа к SC_MANAGER_MODIFY_BOOT_CONFIG. Дополнительные сведения см. в разделе Service Security and Access Rights.

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winsvc.h (включая Windows.h)
Библиотека	Advapi32.lib
DLL	Advapi32.dll

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

Автоматический запуск служб

Функции службы

Поделиться через