version 6.0
Ecrire proprietes groupe (réfGroupe; nom; propriétaire{; membres}) Numérique
Paramètre | Type | Description | |
réfGroupe | Numérique | Numéro de référence unique du groupe activé ou | |
-1 pour ajouter un groupe de Super_Utilisateur | |||
-2 pour ajouter un groupe d'Administrateur | |||
nom | Alpha | Nouveau nom de groupe | |
propriétaire | Numérique | Numéro de référence unique de l'utilisateur ou | |
le propriétaire du nouveau groupe | |||
membres | Tableau num | Nouveaux membres du groupe | |
Résultat | Numérique | Numéro de référence unique du nouveau groupe |
Description
Ecrire proprietes groupe vous permet de modifier et de mettre à jour les propriétés d'un groupe existant dont vous passez le numéro de référence unique dans réfGroupe, ou d'ajouter un nouveau groupe affilié au Super_Utilisateur ou à l'Administrateur.
Si vous modifiez les propriétés d'un groupe existant, vous devez passer son numéro de référence tel que retourné dans la commande LIRE LISTE GROUPE. Les numéros de référence de groupe sont les suivants :
Numéro de référence | Description du groupe |
du groupe | |
15001 à 32767 | Groupe créé par le Super_Utilisateur ou le propriétaire du groupe |
(le groupe n°15001 est le 1er groupe créé par le Super_Utilisateur, | |
le groupe n°15002 est le second, etc. | |
-15001 à -32768 | Groupe créé par l'Administrateur ou le propriétaire du groupe |
(le groupe n°-15001 est le 1er groupe créé par l'Administrateur, | |
le groupe n°-15002 est le second, etc. |
Si vous voulez ajouter un nouveau groupe affilié au Super_Utilisateur, passez -1 dans réfGroupe. Si vous voulez ajouter un nouveau groupe affilié à l'Administrateur, passez -2 dans réfGroupe.
Si le groupe a bien été créé, Ecrire proprietes groupe retourne son numéro de référence unique.
Si vous ne passez pas -1, -2 ou un numéro de référence de groupe valide, Ecrire proprietes groupe ne fait rien et retourne 0.
Avant d'appeler cette routine, vous passez le nouveau nom du groupe et le numéro du propriétaire du groupe dans les paramètres nom et propriétaire. Si vous ne voulez pas modifier toutes les propriétés du groupe (à part ses membres, voir ci-dessous), passez les valeurs retournées par LIRE PROPRIETES GROUPE dans les paramètres que vous voulez laisser inchangés.
Si vous ne passez pas le paramètre optionnel membres, la liste courante des membres du groupe reste inchangée. Si vous le faites lors d'une création d'un groupe, le groupe n'aura pas de membres.
Note : Le propriétaire d'un groupe n'est pas automatiquement défini comme membre du groupe qu'il possède. C'est à vous de l'y inclure explicitement, à l'aide du paramètre membres.
Si vous passez le paramètre optionnel membres, vous modifiez toute la liste des membres pour ce groupe. Avant d'appeler cette routine, vous devez remplir le tableau membres avec les numéros de référence uniques des utilisateurs et/ou des groupes devant appartenir au groupe. Ces numéros peuvent être les suivants :
Numéro de référence | Description membre |
du membre | |
1 | Super_Utilisateur |
2 | Administrateur |
1 à 15000 | Utilisateur créé par le Super_Utilisateur |
(l'utilisateur n°3 est le 1er utilisateur créé par le Super_Utilisateur, | |
l'utilisateur n°4 est le second, et ainsi de suite). | |
-11 à -15010 | Utilisateur créé par l'Administrateur |
(l'utilisateur n°-11 est le 1er utilisateur créé par l'Administrateur, | |
l'utilisateur n°-12 est le second, et ainsi de suite). | |
15001 à 32767 | Groupe créé par le Super_Utilisateur ou le propriétaire du groupe |
(le groupe n°15001 est le 1er groupe créé par le Super_Utilisateur, | |
le groupe n°15002 est le second, etc. | |
-15011 à -32768 | Groupe créé par l'Administrateur ou le propriétaire du groupe |
(le groupe n°-15001 est le 1er groupe créé par l'Administrateur, | |
le groupe n°-15002 est le second, etc. |
Si vous voulez enlever tous les membres d'un groupe, passez un tableau vide dans le paramètre membres.
Référence
LIRE LISTE GROUPE, LIRE LISTE UTILISATEURS, LIRE PROPRIETES GROUPE.
Gestion des erreurs
Si vous n'avez pas les privilèges d'accès pour appeler la commande Ecrire proprietes groupe ou si le système de mots de passe est déjà ouvert par un autre process, une erreur de privilège d'accès est générée. Vous pouvez intercepter cette erreur avec une méthode de gestion d'erreurs installée par APPELER SUR ERREUR.