NotifyBootConfigStatus

  BOOL NotifyBootConfigStatus(BootAcceptable)    
  BOOL BootAcceptable;    

The NotifyBootConfigStatus function can be called to save the configuration which the running system is booted from. It is useful to do this once the configuration has been checked out and found acceptable so that the latest modifications to the configuration can be saved away as the last-known-good.

Parameters

BootAcceptable

If TRUE the configuration which booted the system is saved as the last-known-good configuration. If FALSE, the system will immediately be rebooted using the previously saved last-known-good configuration.

Return Value

This function does not return if BootAcceptable parameter specified is FALSE.

Returns TRUE if successfully saved a new last-known-good configuration. If return value is FALSE, an error has occurred. Use GetLastError to determine the cause of failure.

Comments

If the configuration is detected as not acceptable, a call to this function can instigate a reboot with the last-known-good configuration.

This function can only be called by a process running in the LocalSystem or Administrator security context.