ExeRemoteRun (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ExeRemoteRun (Function)

In french: LanceAppliDistante

Starts running a remote program from the current application. This application can be run by using a specific user account. This application must have no interface.

Remark: The program started remotely will not be able to access the network.

Example

// Start a remote application (advanced use)
AppToStart is Process
AppToStart..Executable = "myapp.exe"
AppToStart..CommandLine = "/SILENT"
AppToStart..ExecutionLogin = "DOMAIN\USER"
AppToStart..ExecutionPassword = "mypassword"

ExeRemoteRun(AppToStart, exeReturnValue, "COMPUTER2")
WHILE AppToStart..ExecutionInProgress = True
Wait(100)
END

Trace(AppToStart..ReturnValue)

Syntax

Starting a remote application with the current user account Hide the details

<Result> = ExeRemoteRun(<Command line> , <Element to return> , <Address of Remote Computer> [, <Connection login> [, <Connection password>]])

<Result>: Integer

Corresponds to the information requested by <Element to return>:
if the exeReturnValue constant was specified, <Result> corresponds to the return code specified by the RETURN statement.
if the exePID constant was specified, <Result> corresponds to the identifier of process of application run (PID).

<Command line>: Character string

Command line to run. The specified application must be installed on the remote computer. The paths used in this command line must be valid on the remote computer.

<Element to return>: Integer constant

Configures the function result:
exeReturnValue The current program resumes its execution when the program run is over. <Result> corresponds to the return value of executable.

Caution: The remote application must be run in less than one hour. Otherwise, the value returned after an hour will be 0.
exePID The current program and the program run are run in parallel. <Result> corresponds to the identifier of created process (also called PID) if the executable was successfully run, 0 if an error occurred.

<Address of Remote Computer>: Character string

IP address of server in xxx.xxx.xxx.xxx format (returned by NetIPAddress) or name of server (returned by NetMachineName).

<Connection login>: Optional character string

Username that will be used to connect to the remote computer. This parameter has the following format: "Domain\User".
The current user account is used if this parameter is not specified.

<Connection password>: Optional character string

Password associated with <Connection Login>.
This parameter is mandatory if <Connection Login> is specified.

Starting a remote application (advanced use) Hide the details

<Result> = ExeRemoteRun(<Process> , <Element to return> , <Address of Remote Computer> [, <Connection login> [, <Connection password>]])