Method ServiceController():setErrorControl() Foundation

Set new error control value and retrieve old one.

Syntax
:setErrorControl( <cName>, ;
                 [<nErrorControl>] ) --> NIL | nOldErrorControl
Parameters
<cName>
The name of the service whose service controller is to be reconfigured.
<nErrorControl>
This parameter controls how the operating system continues to boot when an error occurs while a service is started. #define constants from the SERVICE.CH file must be used:
#define constants for <nErrorControl>
Constant Description
SERVICE_ERROR_IGNORE The operating system continues to boot
SERVICE_ERROR_NORMAL *) The operating system continues to boot after a message box is displayed
SERVICE_ERROR_SEVERE If the service cannot be started, the operating system is re-booted with the last-known-good-configuration. If the service fails again, the service is not started and the operating system continues booting with the last-known-good-configuration.
SERVICE_ERROR_CRITICAL If the operating system is re-booted with the last-known-good-configuration, and the service cannot be started, the operating system aborts its boot procedure.
  1. default
Return

This class method returns the old error control value. When NIL is returned, the appropriate controller is not yet registered with the class method :addController().

Description

<nErrorControl> instructs the operating system how to react when the start of the specified service fails.

it is essential to call this class method prior to calling the class method :install().

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.