ServiceStart (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Operating mode
Limitation

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Functions for managing services

ServiceStart (Function)

In french: ServiceDémarre

Starts a service. This service can be found on the local computer or on a remote computer.

Example

// Starts the service found in the TABLE_Service table
IF ServiceStart(COL_Name[TABLE_Service]) = False THEN
Error(ErrorInfo(errMessage))
END

Syntax

<Result> = ServiceStart(<Service Name> [, <Command Line> [, <Remote Computer>]])

<Result>: Boolean

True if the request for restart was sent,
False otherwise. To find out the error details, use ErrorInfo.

<Service Name>: Character string (with quotes)

Name of the service to start.

<Command Line>: Optional character string (with quotes)

Command line to pass to the service before it is started. This parameter must not be specified if you are using a service created with WINDEV.

<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 start 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

ServiceStart sends a request for starting a service 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.

Component : wd240std.dll