ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Standard functions / Service functions
  • Service variable
  • Notes about the modification
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
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
// Obtenir les caractéristiques du service présent dans la table TABLE_Service
IF ServiceInfo(COL_Nom[TABLE_Service]) = False THEN
	Error(ErrorInfo(errMessage))
ELSE
	Info("Variable Service mise à jour")
	// Changement des caractéristiques
	Service.Startup = serviceStartupAutomatic
	// Modification
	IF ServiceModify(COL_Nom[TABLE_Service]) = True THEN
		Info("Service modifié")
	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 is an empty string (""), the service is handled locally.
Remarks

Service variable

The Service variable is used to configure the following elements. For more details, see the help page on the Service variable.
Service.CommandLineFull command line of the service (path of the executable and parameters).
Service.DescriptionService description
Service.PasswordPassword of the user account
Service.StartupMode for starting the service
Service.StartupErrorThe errors that occurred when starting a service are processed by Windows (for the services with automatic start).
Service.TypeType of the service
Service.UserUser 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.
Component: wd300std.dll
Minimum version required
  • Version 12
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/27/2025

Send a report | Local help