ServiceWaitStatus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Functions for managing services

ServiceWaitStatus (Function)

In french: ServiceAttendEtat

Waits for a service to be in a specific status. This service can be found on the local computer or on a remote computer.

Example

See additional examples

// Wait for the service in TABLE_Service to start
Res is int
ServiceStart(COL_Name[TABLE_Service])
Res = ServiceWaitStatus(COL_Name[TABLE_Service], serviceStatusStarted, 10)
IF Res = -1 THEN
Error(ErrorInfo())
ELSE
Info("Status at the end of timeout: " + StatusInText(Res))
END

Syntax

<Result> = ServiceWaitStatus(<Service name> , <Expected status> [, <Timeout> [, <Remote computer>]])

<Result>: Integer constant

Current status of the service,
serviceStatusStopped The service is stopped.
serviceStatusStopping The service received a command to stop but it has not been stopped yet.
serviceStatusStarting The service received a command to start but it has not been started yet.
serviceStatusPausing The service received a command to pause but it has not been paused yet.
serviceStatusRestarting The service received a command to restart but it has not been restarted yet.
serviceStatusStarted The service is currently operating.
serviceStatusPaused The service is paused.
serviceStatusTimeout The service has not reached the requested status at the end of the timeout.
-1 if an error occurred. For more details about the error, use the ErrorInfo function.

<Service name>: Character string (with quotes)

Name of the service to use.

<Expected status>: Integer constant

Expected status of the service:
serviceStatusStopped The service is stopped.
serviceStatusStopping The service received a command to stop but it has not been stopped yet.
serviceStatusStarting The service received a command to start but it has not been started yet.
serviceStatusPausing The service received a command to pause but it has not been paused yet.
serviceStatusRestarting The service received a command to restart but it has not been restarted yet.
serviceStatusStarted The service is currently operating.
serviceStatusPaused The service is paused.

<Timeout>: Optional integer or optional Duration

Maximum timeout (in seconds). This parameter can correspond to:
an integer corresponding to the number of seconds,
a Duration variable,
Versions 23 and later
direct indication of Duration (e.g. 1 s).
New in version 23
direct indication of Duration (e.g. 1 s).
direct indication of Duration (e.g. 1 s).
If this parameter is not specified, the timeout is set to 10 seconds.

<Remote computer>: Optional character string (with quotes)

IP address of the remote computer in xxx.xxx.xxx.xxx format (returned by NetIPAddress),
Name of the remote computer (returned by NetMachineName).
This parameter is used to handle 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

The functions for service management do not operate in the following operating systems: Windows 98 or Me.

Component : wd260std.dll