HModifyServerRights (Function)

// Copy the rights from a user to another one
Rights is string
Rights = HInfoServerRights("MyConnection", "Smith", hRightsCreateDB)
HModifyServerRights("MyConnection", "Doe", hRightsCreateDB, Rights)

Syntax

<Result> = HModifyServerRights(<Connection> , <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>: Character string (with or without quotes) or Connection variable

Connection for which the rights granted to a user or to a group of users must be modified. This connection corresponds to:
the name of the connection defined in the data model editor or with HDescribeConnection or HOpenConnection.
the name of a Connection variable..

<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:
hRightsStopServer Rights to stop a server (HStopServer).
hRightsChangeRights Rights to change the rights.
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).
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.
hRightsSendMessageToClient Rights to send messages to the client computers.
hRightsManageTask Rights to manage the scheduled tasks.
hRightsManageServer Rights to use HSetServer.
hRightsManageUser Rights to delete and add users or groups.
hRightsReadLogStat Rights to see the activity statistics and the logs of the server.
hRightsPriority Rights to modify the priority of the current application (HPriority) or the priority of another client application (HPriorityClient).
Versions 18 and later
hRightsServerReplication
New in version 18
hRightsServerReplication
hRightsServerReplication Rights to define and perform a replication between two HFSQL servers.
hRightsBackup Rights to perform a backup.
hRightsSeeUser Rights 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:
hAllowed The relevant rights are granted to the user or to the group.
hForbidden The relevant rights are not granted to the user or to the group.
hInherit The user will inherit from the value of the rights granted to the group to which he belongs.

Remarks

When is the modification of rights performed?

The modification of rights is effective as soon as HModifyServerRights 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:

	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

Component : wd250hf.dll