4D v14.3

GET GROUP PROPERTIES

Home

 
4D v14.3
GET GROUP PROPERTIES

GET GROUP PROPERTIES 


 

GET GROUP PROPERTIES ( groupID ; name ; owner {; members} )  
Parameter Type   Description
groupID  Longint in Unique group ID number
name  String in Name of the group
owner  Longint in User ID number of group owner
members  Longint array in Group members

GET GROUP PROPERTIES returns the properties of the group whose unique group ID number you pass in groupID. You must pass a valid group ID number returned by the command GET GROUP LIST. Group ID numbers can have the following values or ranges:

Group ID number Group description
15001 to 32767Group created by the Designer or affiliated Group Owner
(group #15001 is the first group created by the Designer, group #15002 the second, and so on).
-15001 to -32768Group created by the Administrator or affiliated Group Owner
(group #-15001 is the first group created by the Administrator, group #-15002 the second, and so on).

If you do not pass a valid group ID number, GET GROUP PROPERTIES returns empty parameters.

After the call, you retrieve the name and owner of the group, in the parameters name and owner.

If you pass the optional members parameter, the unique ID numbers of the users and groups belonging to the group are returned. Member ID numbers can have the following ranges:

Member ID number Member Description
1Designer user
2Administrator user
3 to 15000User created by the Designer of the database
(user #3 is the first user created by the Designer, user #4 the second, and so on).
-11 to -15000User created by the Administrator of the database
(user #-11 is the first user created by the Designer, user #-12 is the second, and so on).
15001 to 32767Group created by the Designer or affiliated Group Owner
(group #15001 is the first group created by the Designer, group #15002 the second, and so on).
-15001 to -32768Group created by the Administrator or affiliated Group Owner
(group #-15001 is the first group created by the Administrator, group #-15002 the second, and so on).

If you do not have the proper access privileges for calling GET GROUP PROPERTIES or if the Password system is already accessed by another process, an access privilege error is generated. You can catch this error with an error-handling method installed using ON ERR CALL.

 
PROPERTIES 

Product: 4D
Theme: Users and Groups
Number: 613

This command modifies the Error system variable

 
HISTORY 

Created: 4D v6

 
SEE ALSO 

GET GROUP LIST
GET USER LIST
Set group properties

 
ARTICLE USAGE

4D Language Reference ( 4D v11 SQL Release 6)
4D Language Reference ( 4D v12.4)
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)