Help / WLanguage / Managing databases / HFSQL / HFSQL Client/Server functions
  • When are rights changed?
  • What are the rights required to add and/or to modify the users or the groups?
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
<Connection variable>.ModifyServerRights (Function)
In french: <Variable Connexion>.ModifieDroitServeur
HFSQL Client/ServerAvailable only with this kind of connection
Modifies the rights granted to a user or to a group on an HFSQL server.
Remark: to find out the rights granted to a group or to a user on an HFSQL server, use <Connection variable>.InfoServerRights.
// Describe the connection
MyConnection is Connection
// Copy the rights from a user to another one
Rights is string
Rights = MyConnection.InfoServerRights("Smith", hRightsCreateDB)
MyConnection.ModifyServerRights("Doe", hRightsCreateDB, Rights)
<Result> = <Connection>.ModifyServerRights(<User/Group> , <Rights to modify> , <New values>)
<Result>: Boolean
  • True if the rights have been modified,
  • False otherwise. HErrorInfo is used to identify the error. No modification is performed if the new value is already assigned to the specified rights.
Remark: HErrorInfo will return an "Unknown user" or "Unknown group" error if the current user does not have the rights to see the users (hRightsSeeUser constant) and if he wants to get information about another user or another group.
<Connection>: Connection variable
Name of the Connection variable that describes the connection for which the rights of a user or group of users must be modified.
<User/Group>: Character string
Name of the user or group whose rights must be modified.
<Rights to modify>: Integer constant (or combination of constants)
List of rights to modify:
hRightsBackupRights to perform a backup.
hRightsChangePasswordRights to change the password of a user on the server (the user can change his own password and the administrator can change the password of each user).
hRightsChangeRightsRights to change rights.
hRightsCreateDBRights to create a database.
Remark: The rights to create a database automatically give the rights to connect to this database when it is created.
hRightsDisconnectClientRights to disconnect the client computers.
hRightsManageServerRights to use <Connection variable>.SetServer.
hRightsManageTaskRights to manage the scheduled tasks.
hRightsManageUserRights to delete and add users or groups.
hRightsPriorityRights to modify the priority of the current application (<Connection variable>.Priority) or the priority of another client application (<Connection variable>.PriorityClient).
hRightsReadLogStatRights to see the activity statistics and the logs of the server.
hRightsSeeUserRights to see the information regarding the users and the groups.
hRightsSendMessageToClientRights to send messages to the client computers.
hRightsServerReplicationRights to define and perform a replication between two HFSQL servers.
hRightsStopServerRights to stop a server (<Connection variable>.StopServer).
<New values>: Integer constants
List of new values for the modified rights. New values must be assigned to all the rights specified in <Rights to modify> (in the same order).
If a single value is indicated in this parameter, it will be assigned to all the rights specified in <Rights to modify>.
The possible values are as follows:
hAllowedThe relevant rights are granted to the user or group.
hForbiddenThe relevant rights are not granted to the user or group.
hInheritThe user will inherit from the value of the rights granted to the group to which he belongs.

When are rights changed?

The change is effective as soon as <Connection variable>.ModifyServerRights is run. There is no need to restart the server to take the new rights into account.

What are the rights required to add and/or to modify the users or the groups?

The table below presents the rights required to handle the characteristics of groups and users:
Actions on the other users or groups (other than the current user and group)
Modify the name of a user or group
Add a user or a group
Modify the characteristics of the current user or group
See the users or the groups
Component: wd280hf.dll
Minimum version required
  • Version 25
This page is also available for…
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help