Home | Sign in | English EN

This content has been translated automatically. Click here to view the French version.
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Allows you to find out the rights granted to a user or group of users on a server. The server used was defined in the connection.
Remark: From version 19, HFSQL is the new name of HyperFileSQL.
UnDroit is string
// Récupère le droit de création de base de données de
// l'utilisateur Dupont sur le serveur de la connexion CNX
UnDroit = HInfoServerRights("CNX", "Dupont", hRightsCreateDB)
CASE hAllowed
CASE hForbidden
CASE hInherit
<Result> = HInfoServerRights(<Connection> , <User/Group> , <Rights> [, <Display mode>])
<Result>: Character string
  • Requested information,
  • Empty string ("") if an error occurred,
  • "Unknown user" or "Unknown group" if the current user has no permissions to see other users (hRightsSeeUser constant) and wants to get information about another user or group.
In hDefault mode, <Result> is a list of values separated by tabs. Each value in the list corresponds to the rights requested by <Rights>. The values in the list can correspond to one of the following constants:
hAllowedThe relevant rights are granted to the user or group.
hForbiddenThe relevant rights are not granted to the user or group.
hInheritThe user belongs to at least one group to which the relevant rights were granted.
This constant is returned only if the display mode is not set to hEffective.

In hDetails mode, <Result> is a list of values with the following format:
<Droit considéré 1> + TAB + <Valeur du droit 1> + RC + ...
<Droit considéré N> + TAB + <Valeur du droit N> + RC

The rights correspond to the constants used in the <Rights> parameters and the values of the rights correspond to the hAllowed, hForbidden or hInherit constants (see the above table).
<Connection>: Character string or Connection variable
Connection for which the rights of a user or group of users must be known. This connection corresponds to:
<User/Group>: Character string
Name of the user or group whose rights must be known.
<Rights>: Integer constant (or combination of constants)
List of rights to find:
hRightsStopServerRights to stop a server (HStopServer).
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.
hRightsDisconnectClientRights to disconnect the client computers.
hRightsSendMessageToClientRights to send messages to the client computers.
hRightsManageTaskRights to manage the scheduled tasks.
hRightsManageServerRights to use HSetServer.
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 (HPriority) or the priority of another client application (HPriorityClient).
Versions 18 and later
New in version 18
Rights to define and perform a replication between two HFSQL servers.
hRightsBackupRights to perform a backup. This information is not returned by the constant hRightsAll used with the function HInfoServerRights. This information is returned by the hRightsAll constant used with HInfoDatabaseRights.
hRightsAllList of all the rights.
We recommend that you use this constant in hDetails or hEffective + hDetails display mode.
hRightsSeeUserRights to see the different users and groups.
<Display mode>: Optional Integer constant
Result display mode:
(Default value)
The rights returned do not take the inherited rights into account (rights granted to the groups to which the user belongs).
If no rights were defined, the value will be set to hInherit.
<Result> contains the values of the requested rights (in the same order).
hDetailsSame as hDefault.
<Result> contains the rights and there value.
hEffectiveThe rights returned correspond to the rights actually granted to the user or to the group on the server. The inherited rights are taken into account (rights granted to the groups to which the user belongs for example).
hEffective + hDetailsSame as hEffective.
<Result> contains the rights and there value.
To modify the rights granted to a user or to a group on a server, use HModifyServerRights.
Component: wd270hf.dll
Minimum version required
  • Version 9
This page is also available for…
13 Jul. 2019