AppControl (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

AppControl (Function)

In french: AppliContrôle

Warning
From version 23, AppliControl is kept for backward compatibility. This function is replaced by AppControl.

This function is an advanced function. The management of the remote check for a WINDEV application is automatically implemented when installing an application in network.

This function must be used to customize the management mode of the remote check.

Enables (or disables) the remote control for the current multi-user WINDEV application. The remote control allows you to "softly" disconnect the users from the WINDEV application in order to update the application (database update for example).

The remote control is used to:

prevent from connecting to an application,
notify the user that the application will be closed for update,
disconnect a user in order to update the application.

See the principle of remote control for more details.

Example

// Initialization code of project
AppControl("C:\MyApp\FileStop.Txt", WIN_Check)

Syntax

Enabling or disabling the automatic control Hide the details

AppControl(<Name of Control File> [, <Running End Code of Project>])

<Name of Control File>: Character string

Full path of control file (a UNC path can be used). The control file is a text file, with a defined structure (see Structure of control file for more details).
If this parameter corresponds to an empty string (""), the control is disabled for the current application.
WDADMINEXE is used to simplify the creation of control file.

<Running End Code of Project>: Optional boolean

True to run the end code of project during the automatic exit from the application,
False (default value) if the end must of project must not be run.

Automatic control while opening of a custom window Hide the details

AppControl(<Name of Control File> , <Window name>)

<Name of Control File>: Character string

Full path of control file. The control file is a text file, with a defined structure (see Structure of control file for more details).
If this parameter corresponds to an empty string (""), the control is disabled for the current application.
WDADMINEXE is used to simplify the creation of control file.

<Window name>: Character string (with or without quotes)

Name of application window that will be opened to process the messages sent by the remote control. See Remote check: Customizing with a window for more details.
This window must be associated with a procedure of the following type:

PROCEDURE <Window Name> (<Mode>, <Message>, <Display Duration>)

<Mode> Retrieves the current mode for remote control:
acForbidden: access denied to the application
acWarning: warning of imminent shutdown
acStop: application shutdown
<Message> Retrieves the message corresponding to the current mode (this message must be displayed in the window)
<Display Duration> Maximum display duration of the window (in seconds)

Automatic control with custom procedure Hide the details

AppControl(<Name of Control File> , <Procedure name>)

<Name of Control File>: Character string

Full path of control file. The control file is a text file, with a defined structure (see Structure of control file for more details).
If this parameter corresponds to an empty string, the check is disabled for the current application.
WDADMINEXE is used to simplify the creation of control file.

<Procedure name>: Character string (with or without quotes)

Name of procedure called to process the messages sent by the remote control. See Remote check: Customizing with a procedure for more details.
This procedure must be a global procedure of application and it must be declared as follows:

PROCEDURE <Procedure Name> ([<Mode> [, <Message> [, <Display Duration>]]])

<Mode> Retrieves the current mode for remote control:
acForbidden: access denied to the application
acWarning: warning of imminent shutdown
acStop: application shutdown
Caution: When the application is stopped (acStop constant), the program is not stopped automatically: EndProgram must be found in your code in order to end the application.
<Message> Retrieves the message corresponding to the current mode
<Display Duration> Maximum display time of a possible window (in seconds)

Component : wd240vm.dll