NotifyBootConfigStatus

The NotifyBootConfigStatus function notifies the service control manager as to the acceptability of the configuration that booted the system.

An acceptable configuration triggers the storage of that configuration as the last-known good configuration; an unacceptable configuration triggers a system reboot.

BOOL NotifyBootConfigStatus(

BOOL BootAcceptable // indicates acceptability of boot configuration
);  

Parameters

BootAcceptable

Specifies whether the configuration that booted the system is acceptable. If this parameter's value is TRUE, the service control manager saves the configuration that booted the system as the last-known good configuration. If the parameter's value is FALSE, the system immediately reboots, using the previously saved last-known good configuration.

Return Values

If the BootAcceptable parameter is FALSE, the function does not return.

If the last-known good configuration was successfully saved, the return value is nonzero.

If an error occurs, the return value is zero. To get extended error information, call GetLastError.

Errors

The following error codes may be set by the service control manager. Other error codes may be set by the registry functions that are called by the service control manager to set parameters in the configuration registry.

Value Meaning
ERROR_ACCESS_DENIED The user does not have permission to perform this operation.

A hard-coded DACL associated with the service control manager object determines who can perform a NotifyBootConfigStatus operation. Only the operating system and members of the Adminstrators local group can do so.


Remarks

Saving the configuration of a running system with this function is an acceptable method for saving the last-known good configuration.

If the boot configuration is found to be unacceptable, this function can be called to a reboot with the existing last-known good configuration. This function can be called only by a process running in the LocalSystem or the Administrator's security context.