ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Executable functions
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
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.
Remark: The program launched remotely will not be able to access the network..
Example
// Lancement d'une application distante (utilisation avancée)
AppliALancer is Process
AppliALancer.Executable = "monappli.exe"
AppliALancer.CommandLine = "/SILENT"
AppliALancer.ExecutionLogin = "DOMAINE\USER"
AppliALancer.ExecutionPassword = "monmotdepasse"

ExeRemoteRun(AppliALancer, exeReturnValue, "POSTE2")
WHILE AppliALancer.ExecutionInProgress = True
	Wait(100)
END

Trace(AppliALancer.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> [, <Username> [, <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:
exePIDThe current program and the launched program 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.
exeReturnValueThe current program resumes its execution when the program run is over. <Result> is the return value of the executable.

Warning The remote application must run in less than an hour. Otherwise, the value returned after an hour will be 0.
<Address of Remote Computer>: Character string
server IP address in xxx.xxx.xxx.xxx format (returned by NetIPAddress) or name of server (returned by NetMachineName).
<Username>: 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 string or Secret string
Password associated with <Username>.
This parameter is mandatory if <Username> is specified.
New in version 2025
Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "ANSI or Unicode string".
To learn more about secret strings and how to use the vault, see Secret string vault.

Starting a remote application (advanced use) Hide the details

<Result> = ExeRemoteRun(<Process> , <Element to return> , <Address of Remote Computer> [, <Username> [, <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).
<Process>: Process variable
Process variable used to describe the characteristics of the application to run.
<Element to return>: Integer constant
Configures the function result:
exePIDThe current program and the launched program 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.
exeReturnValueThe current program resumes its execution when the program run is over. <Result> is the return value of the executable.

Warning The remote application must run in less than an hour. Otherwise, the value returned after an hour will be 0.
<Address of Remote Computer>: Character string
server IP address in xxx.xxx.xxx.xxx format (returned by NetIPAddress) or name of server (returned by NetMachineName).
<Username>: 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 string or Secret string
Password associated with <Username>.
This parameter is mandatory if <Username> is specified.
New in version 2025
Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "ANSI or Unicode string".
To learn more about secret strings and how to use the vault, see Secret string vault.
Component: wd300std.dll
Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/16/2025

Send a report | Local help