Функция NotifyBootConfigStatus докладывает о состоянии загрузки диспетчеру управления службами. Она используется программой проверки загрузки. Эта функция может быть вызвана только запускающимся процессом в учетной записи LocalSystem или Administrator.
Синтаксис
BOOL NotifyBootConfigStatus( BOOL BootAcceptable ); |
[in] Если это значение равно ИСТИНА (TRUE), система сохраняет последнюю конфигурацию без ошибок. Если это значение - ЛОЖЬ (FALSE), система немедленно перезагружается, используя предварительно сохраненную последнюю конфигурации без ошибок.
Если параметр BootAcceptable - ЛОЖЬ (FALSE), функция не возвращает значения.
Если последняя из известных конфигураций без ошибок была успешно сохранена, возвращаемое значение является ненулевым.
Если происходит ошибка, возвращаемое значение - ноль. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Следующие коды ошибки могут установиться диспетчером управления службами. Другие коды ошибки могут установиться функциями реестра, которые вызывает диспетчер управления службами, чтобы установить параметры в реестре конфигурации.
Код возврата | Описание |
---|---|
ERROR_ACCESS_DENIED | Пользователь не имеет прав выполнить эту операцию. Только система и члены группы Администратора могут сделать это. |
Замечания
Сохранение конфигурации запущенной системы с этой функцией - приемлемый метод чтобы сохранить последнюю из известных конфигураций без ошибок. Если конфигурация загрузки неприемлема, используйте эту функцию, чтобы перезагрузить систему, используя существующую последнюю из известных конфигураций без ошибок.
Этот вызов функции требует права доступа SC_MANAGER_MODIFY_BOOT_CONFIG. Дополнительную информацию смотри в статье Защита службы и права доступа.
Смотри также
Обзор Службы, Функции, используемые службами
Размещение и совместимость NotifyBootConfigStatus |
||
К | Windows XP | Да |
л | Windows 2000 Professional | Да |
и | Windows NT Workstation | Да версии 3,5 и старше |
е | Windows Me | Нет |
н | Windows 98 | Нет |
т | Windows 95 | Нет |
С | Windows Server 2003 | Да |
е | Windows 2000 Server | Да |
р | Windows NT Server | Да версии 3,5 и старше |
в | ||
е | ||
р | ||
Используемая библиотека | Advapi32.lib | |
Используемая DLL | advapi32.dll | |
Заголовочный файл | ||
- объявлено в | Winsvc.h | |
- включено в | Windows.h | |
Unicode | Нет | |
Замечания по платформе | Не имеется |