AutoRunAdd (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Windows management functions

Automatic Application Startup functions

AutoRunAdd

Presentation

Example

Name and directory of executable

Managing errors

See also

AutoRunAdd (Function)

In french: AutoLanceAjoute

Used to:

automatically run a Windows Mobile application according to a specific event. This run is defined from a Windows Mobile application (created with WINDEV Mobile).
automatically run a WINDEV application according to a specific event. This run is defined from a WINDEV application.

In both cases, the application to run can correspond to the current application.

Remark: AutoRunDelete is used to cancel the automatic run of an application.

Example

// -- From a WINDEV Mobile application
// Automatically run the "OrderProducts.exe" application
// as soon as the Mobile Device (Pocket PC) is synchronized
AutoRunAdd(alEndSynchro, "\MyApplications\OrderProducts.exe")

// -- From a WINDEV Mobile application
// Automatically run the current application
// as soon as the Mobile Device (Pocket PC) exits from the standby mode
AutoRunAdd(alExitHibernate, ExeInfo(exeName))

// -- From a WINDEV application
// Automatically run the "MyApp" application
// as soon as the Mobile Device (Pocket PC) connects to the current computer
AutoRunAdd(alConnectionPocket, "MyApp", ...
fExeDir() + "\CustomerManagement.exe")

Syntax

Running a Windows Mobile application from a Windows Mobile application Hide the details

AutoRunAdd(<Run event> , <Name of executable>)

<Run event>: Integer constant

Event that triggers the application run:
alStartup Run the application when starting the Mobile Device (after a reinitialization).
alEndSynchro Run the application once the Mobile Device is synchronized (via ActiveSync).
alExitHibernate Run the application when the Mobile Device exits from the standby mode.

<Name of executable>: Character string (with quotes)

Name and full path of executable for the application to run. This executable is found on the Mobile Device.

Running a WINDEV application from a WINDEV application Hide the details

AutoRunAdd(<Run event> , <Application name> , <Name of executable>)

<Run event>: Integer constant

Event that triggers the application run:
alConnectionPocket Run the application when the Mobile Device connects to the current PC.
To use this constant, you must own the administrator privileges. In Windows Vista (or later) with the UAC mechanism (check of user accounts) enabled, you must have a manifest with the administrator privileges on the application.
alDisconnectionPocket Run the application when the Mobile Device is disconnected from the current PC.
To use this constant, you must own the administrator privileges. In Windows Vista (or later) with the UAC mechanism (check of user accounts) enabled, you must have a manifest with the administrator privileges on the application.
alStartup Run the application when starting the current PC

<Application name>: Character string (with quotes)

Name of application to run. This name will be used in AutoRunDelete.

<Name of executable>: Character string (with quotes)

Name and full path of executable for the application to run. This executable is found on the current PC.
This parameter can contain the command line that will be passed to the executable.

Remarks

Name and directory of executable

ExeInfo associated with the exeName constant returns the full executable name for the current application.
fExeDir returns the directory containing the executable of current application.

Managing errors

Caution: AutoRunAdd returns no error code. To find out whether an error was generated by this function, use the ErrorOccurred variable. If an error occurs, you can get the details of the error with ErrorInfo.

Component: wd260ce.dll