PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Operating mode
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
ServiceControl (Function)
In french: ServiceContrôle
Sends a control message to a service. This service can be found on the local computer or on a remote computer.
Example
// Pauses the service found in TABLE_Service
IF ServiceControl(COL_Name[TABLE_Service], serviceCmdPause) = False THEN
Error(ErrorInfo(errMessage))
END
Syntax
<Result> = ServiceControl(<Service name> , <Command to send> [, <Remote computer>])
<Result>: Boolean
  • True if the command was sent to the service manager,
  • False otherwise. To get more details on the error, use ErrorInfo.
<Service name>: Character string
Name of service to check.
<Command to send>: Integer constant or integer
Command that will be sent to the service:
serviceCmdPausePauses the service (equivalent to ServicePause).
serviceCmdRereadConfigAsks the service to re-read its configuration settings (equivalent to ServiceRefresh).
serviceCmdRestartRestarts a service (equivalent to ServiceContinue).
serviceCmdStopStops the service (equivalent to ServiceStop).

You also have the ability to use an integer included between 128 and 255. This range of values is intended for the commands defined by the service itself (see the documentation about the service for more details).
<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 control 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

Operating mode

ServiceControl sends a command to the service manager. This operation may not be performed immediately. To find out the status of the service, use ServiceWaitStatus.
Component: wd270std.dll
Minimum version required
  • Version 12
This page is also available for…
Comments
Click [Add] to post a comment