HDisconnectClient (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

Management of databases

HFSQL functions

HFSQL Client/Server functions

Customizing the display of messages

HAddScheduledOptimization

HCS.Timeout (Variable)

HDeleteScheduledBackup

HDeleteScheduledOptimization

HExecuteScheduledBackup

HExecuteScheduling

HInfoBackup

HInfoDatabaseProperty

HListScheduledOptimization

HModifyDatabaseProperty

HModifyDatabaseRights

HModifyFileProperty

HModifyFileRights

HModifyGroup

HModifyScheduledBackup

HModifyScheduledOptimization

HModifyScheduling

HModifyServerProperty

HNotifAddEmailRecipient

HNotifConfigure

HNotifDeleteCCRecipient

HNotifDeleteEmailRecipient

HNotifListCCRecipient

HNotifListEmailRecipient

Operating mode
Customizing the display of messages

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HDisconnectClient (Function)

In french: HDéconnecteClient

Available only with this kind of connection

Displays a message on the client computers and disconnects the application. The affected client computers are the computers listed in the HClient structure.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Note: From version 19, HFSQL is the new name of HyperFileSQL.

Versions 22 and later

This function is now available for the iPhone/iPad applications.

This function is now available in Android Widget mode.

This function is now available for the Android applications.

This function is now available for the Java applications.

New in version 22

This function is now available for the iPhone/iPad applications.

This function is now available in Android Widget mode.

This function is now available for the Android applications.

This function is now available for the Java applications.

This function is now available for the iPhone/iPad applications.

This function is now available in Android Widget mode.

This function is now available for the Android applications.

This function is now available for the Java applications.

Example

// Disconnect all users from the "MAILBOX" database
HClient.Database = "MAILBOX"
HDisconnectClient("MyConnection", "Caution: You will be disconnected soon", 300)

Syntax

<Result> = HDisconnectClient(<Connection Name> , <Disconnection Message> , <Display Duration>)

<Result>: Boolean

True if the operation was performed,
False if a problem occurred.
HDisconnectClient is a locking function: the rest of program will be run when the different clients are disconnected.

<Connection Name>: Character string (with or without quotes)

Name of connection to use. This connection was defined in the data model editor, or by HDescribeConnection or HOpenConnection.

<Disconnection Message>: Character string (with quotes)

Message that will be displayed on the client computer before the disconnection.

<Display Duration>: Integer ou Duration

Display duration of message (in seconds). This parameter can correspond to:
an integer corresponding to the number of seconds,
a Duration variable,
Versions 23 and later
the direct indication of duration (1 s for example).
New in version 23
the direct indication of duration (1 s for example).
the direct indication of duration (1 s for example).

Remarks

Operating mode

The client computer specified in the HClient structure displays the message during the specified duration and runs EndProgram when closing the message box.

Customizing the display of messages

HOnServerCall is used to customize the management of message display on the client computer.

Business / GUI classification : Business Logic

Component : wd240hf.dll