PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Service variable
  • Notes about the modification
  • Limitation
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
ServiceModify (Function)
In French: ServiceModifie
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.
Example
// 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 find out the error details, use ErrorInfo.
<Service Name>: Character string (with quotes)
Name of the service to modify.
<Remote Computer>: Optional character string (with quotes)
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 the remote computer.
If this parameter is not specified or if it corresponds to an empty string (""), the service is handled locally.
Remarks

Service variable

The Service variable is used to configure the following elements. See the help page about the Service variable for more details.
Service.StartupMode for starting the service
Service.DescriptionDescription of the service
Service.StartupErrorThe errors that occurred when starting a service are processed by Windows (for the services with automatic start).
Service.CommandLineFull command line of the service (path of the executable and parameters).
Service.TypeType of the service
Service.UserUser account that will run the service.
Service.PasswordPassword of the user account

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 stop and does not restart the service automatically.

Limitation

The functions for service management do not operate in the following operating systems: Windows 98 or Me.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230std.dll
Minimum required version
  • Version 12
This page is also available for…
Comments
Click [Add] to post a comment