NotifyBootConfigStatus 函数 (winsvc.h)

向服务控制管理器报告启动状态。它由启动验证程序使用。此函数只能由 LocalSystem 或管理员帐户中运行的进程调用。

语法

BOOL NotifyBootConfigStatus(
  [in] BOOL BootAcceptable
);

[in] BootAcceptable

如果值为 TRUE，则系统会将配置保存为最后一个已知良好的配置。如果值为 FALSE，则系统会立即重新启动，使用以前保存的最后一个已知良好配置。

如果 BootAcceptable 参数为 FALSE，则函数不会返回。

如果已成功保存上一个已知良好的配置，则返回值为非零值。

如果发生错误，则返回值为 0。要获得更多的错误信息，请调用 GetLastError。

以下错误代码可能由服务控制管理器设置。其他错误代码可能由服务控制管理器调用的注册表函数设置，以在配置注册表中设置参数。

返回代码	说明
ERROR_ACCESS_DENIED	该用户无权执行此操作。只有系统和管理员组的成员才能执行此操作。

使用此函数保存正在运行的系统配置是保存上一个已知良好配置的可接受方法。如果启动配置不可接受，请使用此函数使用现有的上一个已知良好配置重新启动系统。

此函数调用要求调用方令牌具有获取SC_MANAGER_MODIFY_BOOT_CONFIG访问权限的权限。有关详细信息，请参阅服务安全性和访问权限。