|
|
|
|
|
|
|
|
- When are rights changed?
- What are the rights required to add and/or to modify the users or the groups?
<Connection variable>.ModifyServerRights (Function) In french: <Variable Connexion>.ModifieDroitServeur
 Available only with this kind of connection
Modifies the rights granted to a user or to a group on an HFSQL server.
// 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)
Syntax
<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: | | | hRightsBackup | Rights to perform a backup. | | hRightsChangePassword | Rights 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). | | hRightsChangeRights | Rights to change rights. | | hRightsCreateDB | Rights to create a database.
Remark: The rights to create a database automatically give the rights to connect to this database when it is created. | | hRightsDisconnectClient | Rights to disconnect the client computers. | | hRightsManageServer | Rights to use <Connection variable>.SetServer. | | hRightsManageTask | Rights to manage the scheduled tasks. | | hRightsManageUser | Rights to delete and add users or groups. | | hRightsPriority | Rights to modify the priority of the current application (<Connection variable>.Priority) or the priority of another client application (<Connection variable>.PriorityClient). | | hRightsReadLogStat | Rights to see the activity statistics and the logs of the server. | | hRightsSeeUser | Rights to see the information regarding the users and the groups. | | hRightsSendMessageToClient | Rights to send messages to the client computers. | | hRightsServerReplication | Rights to define and perform a replication between two HFSQL servers. | | hRightsStopServer | Rights 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:
| | | hAllowed | The relevant rights are granted to the user or group. | | hForbidden | The relevant rights are not granted to the user or group. | | hInherit | The user will inherit from the value of the rights granted to the group to which he belongs. |
Remarks 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: | | | | hRightsManageUser | hRightsSeeUser |
|---|
| Actions on the other users or groups (other than the current user and group) | | x | | Modify the name of a user or group | x | x | | Add a user or a group | x | x | | Modify the characteristics of the current user or group | x | | | See the users or the groups | | x |
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|