PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Operating mode
  • 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
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.
Versions 15 and later
WINDEVLinux This function is now available for the WINDEV applications in Linux.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
New in version 15
WINDEVLinux This function is now available for the WINDEV applications in Linux.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
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 find out the error details, use ErrorInfo.
<Service Name>: Character string (with quotes)
Name of service to check.
<Command to Send>: Integer constant or integer
Command that will be sent to the service:
serviceCmdStopStops the service (equivalent to ServiceStop).
serviceCmdPausePauses the service (equivalent to ServicePause).
serviceCmdRestartRestarts a service (equivalent to ServiceContinue).
serviceCmdRereadConfigAsks the service to re-read its configuration settings (equivalent to ServiceRefresh).
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 (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 control 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

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.

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
Linux wd230std.so
Minimum required version
  • Version 12
This page is also available for…
Comments
Click [Add] to post a comment