Modifies the configuration of a service according to the information given in the members of the
Service variable. This service can be found on the local computer or on a remote computer.
// Find out the characteristics of the service found in TABLE_Service
IF ServiceInfo(COL_Name[TABLE_Service]) = False THEN
Error(ErrorInfo(errMessage))
ELSE
Info("The Service variable is updated")
// Change the characteristics
Service.Startup = serviceStartupAutomatic
// Modification
IF ServiceModify(COL_Name[TABLE_Service]) = True THEN
Info("The service was modified")
END
END
Syntax
<Result> = ServiceModify(<Service name> [, <Remote computer>])
<Result>: Boolean
- True if the modification was requested,
- False otherwise. To get more details on the error, use ErrorInfo.
<Service name>: Character string
Name of the service to modify.
<Remote computer>: Optional character string
IP address of the remote computer in xxx.xxx.xxx.xxx format (returned by NetIPAddress) or name of the remote computer (returned by NetMachineName). This parameter is used to modify a service on another computer. To use this option, the user must be administrator of remote computer.
If this parameter is not specified or if it corresponds to an empty string (""), the service is handled locally.
Remarks
The Service variable is used to configure the following elements. For more details, see the help page on the
Service variable.
| |
| Service.CommandLine | Full command line of the service (path of the executable and parameters). |
| Service.Description | Service description |
| Service.Password | Password of the user account |
| Service.Startup | Mode for starting the service |
| Service.StartupError | The errors that occurred when starting a service are processed by Windows (for the services with automatic start). |
| Service.Type | Type of the service |
| Service.User | User account that will run the service. |
Notes about the modification
- The type of an existing service cannot be modified.
- The modifications are taken into account when the service is started. ServiceModify does not automatically stop or restart the service.