HOnServerCall (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

HOnServerCall

Presentation

Example

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

Customizing the display of messages
Various

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Functions for HFSQL Client/Server management

HOnServerCall (Function)

In french: HSurAppelServeur

Available only with this kind of connection

Customizes the management of message display on the client computer and the management of disconnection from a client computer.

Reminder: Sending a message to the client computer is performed by HSendMessageToClient. The disconnection of a client computer is performed by HDisconnectClient.

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.

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

Versions 20 and later

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

This function is now available for the WEBDEV sites in Linux.

This function is now available for the WINDEV applications in Linux.

New in version 20

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

This function is now available for the WEBDEV sites in Linux.

This function is now available for the WINDEV applications in Linux.

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

This function is now available for the WEBDEV sites in Linux.

This function is now available for the WINDEV applications in Linux.

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.

Versions 22 and later

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 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 in Android Widget mode.

This function is now available for the Android applications.

This function is now available for the Java applications.

Example

// Customize the Client messages
// The ClientMessage procedure is called
// whenever HSendMessageToClient is used
HOnServerCall(hMessage, "ClientMessage")

// ClientMessage procedure
PROCEDURE ClientMessage(Type, MessageToDisplay, DurationMessageDisplay)
IF Type = hMessage THEN
Open(WIN_MyWin, MessageToDisplay)
END

Syntax

<Result> = HOnServerCall(<Type of Message> [, <Name of WLanguage Procedure> [, <Options>]])

<Result>: Boolean

True if the operation was successfully performed,
False otherwise. HError returns more details about the problem.

<Type of Message>: Integer constant

Type of message to configure.
hDisconnection Configure the disconnection message.
hMessage Configure the information message

<Name of WLanguage Procedure>: Optional character string

Procedure that must be called when a <Message Type> message is displayed.
This procedure has the following format:

PROCEDURE <Procedure Name>(<Message Type>, <Message>, <Display Duration>)

If this parameter is not specified, the message will be displayed in the default window.
If this parameter is equal to an empty string (""), the automatic management will be disabled. In case of a disconnection, the connection will be closed by the server. An error will be displayed during the next access to a data file.

<Options>: Integer constant

Versions 19 and later
Option for running the procedure:
Versions 19 and later
hSecondaryThread
New in version 19
hSecondaryThread
hSecondaryThread The procedure is run in a secondary thread.
If this option is not specified, the procedure is run in the main thread.
New in version 19
Option for running the procedure:
Versions 19 and later
hSecondaryThread
New in version 19
hSecondaryThread
hSecondaryThread The procedure is run in a secondary thread.
If this option is not specified, the procedure is run in the main thread.
Option for running the procedure:
Versions 19 and later
hSecondaryThread
New in version 19
hSecondaryThread
hSecondaryThread The procedure is run in a secondary thread.
If this option is not specified, the procedure is run in the main thread.

Remarks

Customizing the display of messages

All the actions are allowed in the WLanguage procedure.

In case of a disconnection message, the disconnection will be performed after the duration specified in HDisconnectClient (regardless of the actions performed in the procedure).

Various

HOnServerCall must be used in the main thread.
HOnServerCall is global to the entire application, including the components run. If HOnServerCall is used in a component, it will be enabled for the host application (the last call to HOnServerCall is taken into account)

Component : wd240hf.dll