ExeInfo (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Executable functions

Program execution mode
Keywords of API "VerQueryValue" function
Executing the function in test mode in Windows

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ExeInfo (Function)

In french: ExeInfo

Retrieves the specified information about the version of an executable or DLL.

Retrieves the specified information about the version of a module.

Example

ProgVersion is string
ProgVersion = ExeInfo(exeVersion, "Appli.exe")
IF ProgVersion <> "2.0A" THEN
Error("Invalid program version")
END

// Retrieve the application name (without the full path)
ProgName = ExeInfo("OriginalFilename", "App.exe")
// The executable was not renamed
ProgName = fExtractPath(ExeInfo(exeName), fFile + fExtension)

sExeDir is string
IF InTestMode() = True THEN
// In test mode, return the runtime directory
sExeDir = fCurrentDir()
ELSE
sExeDir = ExeInfo(exeDirectory)
END

Syntax

<Result> = ExeInfo(<Keyword> [, <Executable name>])

<Result>: Character string

Requested information.
Empty string ("") if there is no information or if the function failed.

<Keyword>: String constant

Information to retrieve:
exeCompany Name entered for the company when creating the executable.
This constant is not available.
exeCopyright Copyright of program
This constant is not available.
exeDescription Description supplied with the program
Version of JRE (Java Runtime Environment) with which the current application is run.
Android version used to run the application (for example: 4.1). It is recommended to use sysAndroidVersion.
This constant is not available.
This constant only operates with the PC SOFT libraries or executables.
exeDirectory Directory of the executable (without the final \ but with the ":")
This constant is not available.
exeLaunch
Mode for starting the Android or iOS application.
If this constant is specified, <Result> can correspond to:
empty string ("") if the application was manually started by the user.
the exeStartup constant if the application was automatically started by the system, when starting the device.
the exePushNotification constant if the application was automatically started by the system further to the reception of a push notification.
the exeInBackground constant if the application was started in the background (detection of group of Beacons or during geolocation tracking).
the exeGeoTracking constant if the application was started in the background during the geolocation tracking. For more details, see Geolocation tracking.
This constant is kept for backward compatibility from version 230050. It is equivalent to the exeInBackground constant.
the exeDownloadComplete constant if the application was automatically launched by the system when a download previously requested by the application is completed (for example, if the application was closed during the download).
the exeDeepLink constant if the application was automatically launched via a "deep link".
the exeQuickAction constant if the application was automatically launched via a quick action.
exeMode Program mode: compiled in 32 or 64-bit mode, etc.
This constant is not available.
This constant returns an empty string ("").
exeName Name and full path of the executable.
Name of runtime module or name of project if the module corresponds to a page or if <Executable name> is not specified.
Name of Java archive for the application currently run.
Caution: This name does not correspond to the name of the application package.
exeVersion Version of specified module.
Version of runtime module or version of module for page generation if the module corresponds to a page or if <Executable name> is not specified.
This constant only operates with the PC SOFT libraries or executables.
Version number of application.
This constant is not available.
exeVersionWindowsFormat Version of specified module in standard Windows format ("14.0.204.98" for example).
This constant is not available.

<Executable name>: Optional character string

Name and full (or relative) path of the executable or module used (up to 260 characters). If this parameter is not specified, the current executable is used.
Name and full (or relative) path of file (up to 260 characters). If this parameter is not specified, the current module is used.
This parameter must not be specified.
This parameter must be specified.

Remarks

Program execution mode

To get the program execution mode, use the exeMode constant:

ProgMode = ExeInfo(exeMode)

The function result can correspond to:

"16" if the Windows program is compiled in 16 bits,
"32" if the Windows program is compiled in 32 bits,
"64" if the Windows program is compiled in 64 bits,
"DOS" if the program is a DOS program,
an empty string ("") if the program is not an executable.

Keywords of API "VerQueryValue" function

The <Keyword> parameter can be replaced with one of the keywords used by the API "VerQueryValue" function:

"Comments" "LegalTrademarks"

"CompanyName" "OriginalFilename"

"FileDescription" "PrivateBuild"

"FileVersion" "ProductName"

"InternalName" "ProductVersion"

"LegalCopyright" "SpecialBuild"

Executing the function in test mode in Windows

When ExeInfo is executed in test mode from WINDEV, the information returned about the current executable is that of "WDTst", the WINDEV test engine (located in the "Programs" subdirectory of the WINDEV installation directory).

Component: wd300std.dll