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.