Функция NotifyBootConfigStatus


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

Синтаксис

BOOL NotifyBootConfigStatus(
  BOOL BootAcceptable
);

Параметры

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 Нет
 Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz