NotifyBootConfigStatus功能通知服务控制管理员有关启动系统的配置的可接受性。
可接受的配置触发该配置的存储作为最后一个已知的良好配置;不可接受的配置触发系统重新启动。
BOOL NotifyBootConfigStatus(
BOOL 【BootAcceptable】 | //表示启动配置的可接受性 |
); |
参数
【BootAcceptable】
指定引导系统的配置是否可以接受。如果此参数的值为TRUE,则服务控制管理器将引导系统的配置保存为最后一个已知的良好配置。如果参数的值为FALSE,系统将立即重新启动,使用先前保存的最后一个已知的良好配置。
返回值
如果【BootAcceptable】参数为FALSE,则该函数不返回。
如果最后知道的良好配置已成功保存,则返回值不为零。
如果发生错误,返回值为零。要获取扩展错误信息,请调用GetLastError.
错误
服务控制管理器可以设置以下错误代码。其他错误代码可能由服务控制管理器调用以在配置注册表中设置参数的注册表函数设置。
值 | 含义 |
ERROR_ACCESS_DENIED | 用户没有执行此操作的权限。 与服务控制管理器对象相关联的硬编码DACL确定谁可以执行NotifyBootConfigStatus操作。只有操作系统和管理员本地组的成员才能这样做。 |
备注
使用此函数保存正在运行的系统的配置是保存最后一个已知的良好配置的可接受的方法。
如果发现引导配置是不可接受的,则可以使用现有的最新知名的良好配置调用此函数重新引导。此函数只能由在LocalSystem或管理员的安全上下文中运行的进程调用。