ExeRunning (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

ExeRunning (Function)

In french: ExeLancé

Allows you to find out whether a 32-bit application is already run.

Remarks:

If the executable is compiled in 64 bits, the function returns the status of a 64-bit process.
If the executable is compiled in 32 bits, the function returns the status of a 32-bit process even if a 64-bit Windows is run.

Versions 16 and later

This function is now available in WEBDEV Server.

This function is used to find out whether an executable is run on the server. Caution: the rights to handle this executable will be the ones of the current Internet user.

New in version 16

This function is now available in WEBDEV Server.

This function is used to find out whether an executable is run on the server. Caution: the rights to handle this executable will be the ones of the current Internet user.

This function is now available in WEBDEV Server.

This function is used to find out whether an executable is run on the server. Caution: the rights to handle this executable will be the ones of the current Internet user.

Example

NbRun is int
NbRun = ExeRunning("C:\WINDEV\PROGRAMS\WINDEV.EXE")
IF NbRun > 0 THEN
Info("You are using WINDEV!")
END

NbRun is int
NbRun = ExeRunning("Calc.EXE")
IF NbRun > 0 THEN
Info("You are using the calculator!")
END

Syntax

Finding out whether the specified executable is run Hide the details

<Result> = ExeRunning([<Executable name> [, <Option>]])

<Result>: Integer

Number of instances of the executable currently run.
0 if the application is not started.
-1 if a problem occurred. For example:
The user has no sufficient rights to list the processes in memory.
The application could not access the system DLL used to enumerate the processes.

<Executable name>: Optional character string (with quotes)

Name and full path of executable (up to 260 characters). In this case, <Result> returns the instances of this specific application.
Name of the executable (up to 260 characters). In this case, <Result> is the number of instances of the program (regardless of its initial path).
If this parameter is not specified, the current executable is used.
Caution: The executable must be a 32-bit application.
Name of the executable (up to 260 characters).
If this parameter contains the full path of the executable, this path is ignored. Only the name of the executable is taken into account.
If this parameter is not specified, the current executable is used.
Caution: The executable must be a 32-bit application.

<Option>: Integer constant

Versions 22 and later
Allows you to specify the type of instances to be counted:
sysCurrentUser Counts the instances of the executable launched by the current user.
sysAllUsers Counts the instances of the executable launched by all users.
New in version 22
Allows you to specify the type of instances to be counted:
sysCurrentUser Counts the instances of the executable launched by the current user.
sysAllUsers Counts the instances of the executable launched by all users.
Allows you to specify the type of instances to be counted:
sysCurrentUser Counts the instances of the executable launched by the current user.
sysAllUsers Counts the instances of the executable launched by all users.

Finding out whether the specified PID is run Hide the details

<Result> = ExeRunning(<Executable PID>)

<Result>: Integer

1 if the application is started.
0 if the application is not started.

<Executable PID>: Integer

PID (Process Identifier) of the executable.

Component: wd260std.dll