PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
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.
Note: 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 RESULT statement.
  • if the exePID constant was specified, <Result> corresponds to the identifier of process of application run (PID).
<Command line>: Character string (with quotes)
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:
exeReturnValueThe 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.
exePIDThe 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 (with quotes)
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 (with quotes)
User name 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 (with quotes)
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>]])
<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 RESULT statement.
  • if the exePID constant was specified, <Result> corresponds to the identifier of process of application run (PID).
<Process>: Process variable
Process variable used to describe the characteristics of the application to run.
<Element to Return>: Integer constant
Configures the function result:
exeReturnValueThe 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.
exePIDThe 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 (with quotes)
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 (with quotes)
User name 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 (with quotes)
Password associated with <Connection Login>.
This parameter is mandatory if <Connection Login> is specified.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230std.dll
Minimum required version
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment