Home | Sign in | English UK

New WINDEV, WEBDEV, WINDEV Mobile 25 feature!
  • When is the modification of rights performed?
  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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 a HFSQL server.
Remark: to find out the rights granted to a group or to a user on a HFSQL server, use <Connection variable>.InfoServerRights.
Remark: From version 19, HFSQL is the new name of HyperFileSQL.
// 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 (with or without quotes)
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:
hRightsStopServerRights to stop a server (<Connection variable>.StopServer).
hRightsChangeRightsRights to change the rights.
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).
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.
hRightsSendMessageToClientRights to send messages to the client computers.
hRightsManageTaskRights to manage the scheduled tasks.
hRightsManageServerRights to use <Connection variable>.SetServer.
hRightsManageUserRights to delete and add users or groups.
hRightsReadLogStatRights to see the activity statistics and the logs of the server.
hRightsPriorityRights to modify the priority of the current application (<Connection variable>.Priority) or the priority of another client application (<Connection variable>.PriorityClient).
Versions 18 and later
New in version 18
Rights to define and perform a replication between two HFSQL servers.
hRightsBackupRights to perform a backup.
hRightsSeeUserRights to see the information regarding the users and the groups.
<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 to the group.
hForbiddenThe relevant rights are not granted to the user or to the group.
hInheritThe user will inherit from the value of the rights granted to the group to which he belongs.

When is the modification of rights performed?

The modification of rights is effective as soon as <Connection variable>.ModifyServerRights is run for the users who are connected and affected by the modification. 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 : wd250hf.dll
Minimum version required
  • Version 25
This page is also available for…
Click [Add] to post a comment