ServiceRefresh (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Operating mode
Limitation

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Service management functions

ServiceRefresh (Function)

In french: ServiceActualise

Asks a service to re-read its configuration information. This service can be found on the local computer or on a remote computer.

Versions 15 and later

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

New in version 15

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

Example

// Refreshes the service found in TABLE_Service
IF ServiceRefresh(COL_Name[TABLE_Service]) = False THEN
Error(ErrorInfo(errMessage))
END

Syntax

<Result> = ServiceRefresh(<Service name> [, <Remote computer>])

<Result>: Boolean

True if the request for refresh was transmitted to the service manager,
False otherwise. To get the details of the error, use ErrorInfo.

<Service name>: Character string

Name of the service to refresh.

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

ServiceRefresh asks the service manager to refresh the service. 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: wd270std.dll