Help / WLanguage / Managing databases / HFSQL / HFSQL Client/Server functions
  • Customization
  • Use conditions
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
HSendMessageToClient (Function)
In french: HEnvoieMessageVersClient
HFSQL Client/ServerAvailable only with this kind of connection
Displays a message on the client computers. The affected Client computers are those specified in the HClient structure.
// Message to all users of "MAILBOX" database
HClient.Database = "MAILBOX"
HSendMessageToClient("MyConnection", "Caution: You will be disconnected soon", 300)
// Message to the "Admin" user of "MyDatabase" database
HClient.Database = "MyDatabase"
HClient.Login = "Admin"
HSendMessageToClient("MyConnection", "Test for sending messages", 15)
// Message to all applications accessing Client.fic 
// found in "MyDatabase"
HClient.Database = "MyDatabase"
HClient.File = "Customer.fic"
HSendMessageToClient("MyConnection", "You are using the Client file", 300)
// Message to all applications run on "Computer1"
//  that use the "Admin" login
HClient.Computer = "Computer1"
HClient.Login = "Admin"
HSendMessageToClient("MyConnection", "Caution: You will be disconnected soon", 300)
<Result> = HSendMessageToClient(<Connection> , <Message> , <Display duration>)
<Result>: Boolean
  • True if the operation was performed,
  • False if a problem occurs.
HSendMessageToClient is a blocking function while the message is being sent to the server. The application continues to run once the message is received by the server.
<Connection>: Character string or Connection variable
Connection to use. This connection corresponds to:
<Message>: Character string
Message that will be displayed on the client computer.
<Display duration>: Integer or Duration
Display duration of message (in seconds). This parameter can be:
  • an integer corresponding to the number of seconds,
  • a Duration variable,
  • the duration in a readable format (e.g., 1 s).


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

Use conditions

  • To use this function, you must have:
    • the "Rights to send messages to the client computers" (hRightsSendMessageToClient constant in HModifyServerRights).
    • the "Rights to see the users and groups" (hRightsSeeUser constant in HModifyServerRights).
  • The message will be sent to the users that the client calling the function is allowed to see.
  • This function can be used to send a message to all the users of an HFSQL cluster.
Component: wd300hf.dll
Minimum version required
  • Version 10
This page is also available for…
Mandar Mensagem Usuarios
HClient.Database = "matos"
HSendMessageToClient(Matos_hyperfil_server, EDT_OBSERVACAO, 15)

// blog com vídeo e exemplo

De matos
16 Jul. 2017

Last update: 06/14/2024

Send a report | Local help