AppChangeParameter (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Functions for managing applications with "live update"

AppChangeParameter (Function)

In french: AppliChangeParamètre

Warning
From version 23, AppliChangeParameter is kept for backward compatibility. This function is replaced by AppChangeParameter.

Changes an information in the mechanism for automatic application update.

Example

IF AppParameter(appUPDMode) = 3 THEN
AppChangeParameter(appUPDMsgStop, ...
"The application " + ProjectInfo(piEXEName) + ...
"will be automatically stopped.")
END

Syntax

<Result> = AppChangeParameter(<Information> , <New value> [, <Application path>])

<Result>: Boolean

True if the requested information was modified,
False if a problem occurred. For more details about the problem, use ErrorInfo.

<Information>: Integer constant

Characteristic of application to modify:
appUPDPath Path of update information on the server.
Constant not available.
appUPDTimeout Time-out between two messages (if appUPDMode = 2) or before the application is automatically stopped (if appUPDMode = 3). This time-out is expressed in seconds.
Constant not available.
appUPDMode Current operating mode of application:
0: Standard operating mode.
1: Startup forbidden: the current executables continue to operate.
2: Startup forbidden: the current executables receive a warning message on a regular basis.
3: Startup forbidden: the current executables are automatically stopped after a given time-out.
Constant not available.
appUPDMsgStop Message displayed before the application is automatically stopped (when appUPDMode = 3).
Constant not available.
appUPDMsgWarning Message displayed on a regular basis (when appUPDMode = 2).
Constant not available.
appUPDMsgForbid Message displayed when the startup of the application is forbidden.
Constant not available.
appUPDProtocol Network protocol used to search for updates. This protocol can correspond to "LOCAL" or to "HTTP".
Only the HTTP protocol is available.
appUPDNetwork Level of update:
0: No update.
The update in network is not used.
1: Network update enabled.
The available updates are checked and the dialog box of automatic update is displayed.
2: Network update enabled and registration of applications toward the update server.
The available updates are checked and the dialog box of automatic update is displayed.
As soon as it is started, the executable creates a ".LOK" file on the server. This file allows WDAdminExe to identify the clients that use the application.
Only the values 0 and 1 are available.
appUPDServer Server where the updates will be sought.
If the HTTP protocol is used, IP address or name of computer.
If the LOCAL protocol is used, name of network share.
Full URL used to search for updates.
appUPDLocalVersion Version number of local executable.

<New value>: Character string (with quotes)

New value that will be given to the specified information.

<Application path>: Optional character string (with quotes)

Full path of executable to use. If this parameter is not specified, the current application will be handled.

Remarks

The new parameters will be taken into account the next time the application is started.

Component : wd250std.dll