|
|
|
|
|
|
|
|
<Connection variable>.ModifyFileRights (Function) In french: <Variable Connexion>.ModifieDroitFichier
 Available only with this kind of connection
Modifies the rights granted to a user or group on an HFSQL Client/Server data file.
// Describe the connection
MyConnection is Connection
// Copy the rights from a user to another one
sRights is string
sRights = MyConnection.InfoFileRights("Moore", ...
hRightsRead + hRightsInsert, "MyDatabase", "MyFile.fic")
MyConnection.ModifyFileRights("Doe", hRightsRead + hRightsInsert, ...
sRights, "MyDatabase", "MyFile.FIC")
Syntax
<Result> = <Connection>.ModifyFileRights(<User/Group> , <Rights to modify> , <New values> , <Database> , <Data file>)
<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: | | | hRightsAutoModif | Rights to perform the automatic modification of data files on a data file. | | hRightsChangeLink | Rights to modify the integrity rules on a data file. | | hRightsChangeOwner | Rights to modify the owner of an element. | | hRightsChangeRights | Rights to change rights. | | hRightsDelete | Rights to delete the records from a data file. | | hRightsDeleteFile | Rights to delete a data file (<Connection variable>.DeleteFile). | | hRightsInsert | Rights to add new records into a data file. | | hRightsLock | Rights to lock the data files or the records of a data file. | | hRightsMaintenance | Rights to start a re-index operation or to perform statistical calculations on a data file. | | hRightsManageDuplicate | Rights to enable and disable the management of duplicates. | | hRightsRead | Rights to read the records of a data file. | | hRightsUpdate | Rights to modify the records of a data file. |
<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. |
<Database>: Character string Name of the database containing the data file for which the rights must be modified. - If the database corresponds to the one defined in the connection, this parameter can correspond to an empty string ("").
- A WLanguage error occurs if no database is defined in the connection and if this parameter corresponds to an empty string.
<Data file>: Character string Name of the data file for which the rights must be modified. Remarks When are rights changed? The change is effective as soon as <Connection variable>.ModifyFileRights is run. There is no need to restart the server to take the new rights into account.
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|