Set group properties

versión 6.0

Set group properties (refGrupo; nombre; propietario{; miembros}) Numérico

Set group properties permite modificar y actualizar las propiedades de un grupo existente cuyo número de referencia único se pasa en refGrupo, o para añadir un nuevo grupo afiliado al Diseñador o al Administrador.

Si modifica las propiedades de un grupo existente, debe pasar un número de referencia válido devuelto por el comando GET GROUP LIST. Los números de referencia de grupo son los siguientes:

15001 a 32767	Grupo creado por el Diseñador o el propietario del grupo
	(el grupo #15001 es el primer grupo creado por el Diseñador,
	el grupo #15002 el segundo, etc.).
-15001 a -32768	Grupo creado por el Administrador o por el propietario del grupo
	(el grupo #-15001 el el primer grupo creado por el Administrador,
	el grupo #-15002 el segundo, etc.).

Para añadir un nuevo grupo afiliado con el Diseñador, pase -1 en RefGrupo. Para añadir un nuevo grupo afiliado al Administrador, pase -2 en refGrupo. Después de la llamada, si el grupo se añadió con éxito, devuelve su número de referencia único en refGrupo.

Si no pasa -1, -2 o un número de referencia de grupo válido, Set group properties no hace nada y devuelve 0.

Antes de llamar esta rutina, pase el nuevo nombre del grupo y el número de propietario del grupo en los parámetros nombre y propietario. Si no quiere cambiar las propiedades del grupo (a parte de los miembros, ver más adelante), primero llame GET GROUP PROPERTIES y pase los parámetros que quiere dejar intactos.

Si no pasa el parámetro opcional miembros, la lista actual de miembros del grupo permanece sin cambios. Si no pasa miembros mientras añade un grupo, el grupo no tendrá miembros.

Nota: El propietario de un grupo no está definido automáticamente como miembro del grupo que posee. Es su decisión incluir al propietario del grupo en el grupo, utilizando el parámetro miembros.

Si pasa el parámetro opcional miembros, modifica toda la lista de miembros para este grupo. Antes de llamar esta rutina, debe llenar el array miembros con los números de referencia únicos de los usuarios y grupos que el grupo tendrá como miembros. Los números de referencia de los miembros pueden tener los siguientes rangos:

1	Diseñador
2	Administrador
3 a15000	Usuario creado por el Diseñador
	(el usuario #3 es el primer usuario creado por el Diseñador,
	el usuario #4 es el segundo, etc.).
-11 a -15000	Usuario creado por el Administrador
	(el usuario #-11 es el primer usuario creado por el Administrador,
	usuario #-12 es el segundo, etc.).
15001 a 32767	Grupo creado por el Diseñador o Propietario del grupo
	(el grupo #15001 es el primer grupo creado por el Diseñador,
	el grupo #15002 es el segundo, etc.).
-15001 a -32768	Grupo creado por el Administrador o Propietario del grupo
	(el grupo #-15001 es el primer grupo creado por el Administrador,
	el grupo #-15002 es el segundo, etc.).

Para eliminar todos los miembros de un grupo, pase un array vacío en el parámetro miembros.

GET GROUP LIST, GET GROUP PROPERTIES, GET USER LIST.

Si no tiene privilegios de acceso para llamar al comando Set group properties o si otro proceso abrió en el sistema de contraseñas, se genera un error de privilegios de acceso. Puede interceptar este error con un método de gestión de errores instalado por ON ERR CALL.