|
|
|
|
|
|
|
|
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.
// 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: | | | serviceCmdPause | Pauses the service (equivalent to ServicePause). | | serviceCmdRereadConfig | Asks the service to re-read its configuration settings (equivalent to ServiceRefresh). | | serviceCmdRestart | Restarts a service (equivalent to ServiceContinue). | | serviceCmdStop | Stops 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 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.
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|