Guardian Procedure Calls Reference Manual

GROUP_GETINFO_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
The GROUP_GETINFO_ procedure returns attributes of the specified group, such as the group's
textual description and whether the group is automatically deleted when the last member is deleted.
The group can be identified by group name or group ID.
Syntax for C Programmers
#include <cextdecs(GROUP_GETINFO_)>
short GROUP_GETINFO_ ( [ char *group-name ]
,[ short group-maxlen ]
,[ short *group-curlen ]
,[ __int32_t *groupid ]
,[ short *is-auto-delete ]
,[ char *descrip ]
,[ short descrip-maxlen ]
,[ short *descriplen ] );
Syntax for TAL Programmers
error := GROUP_GETINFO_ ( [ group-name:group-maxlen ] ! i,o:i
,[ group-curlen ] ! i,o
,[ groupid ] ! i,o
,[ is-auto-delete ] ! o
,[ descrip:descrip-maxlen ] ! o:i
,[ descriplen ] ); ! o
Parameters
group-name:group-maxlen
input, output:input
STRING .EXT:ref:*, INT:value
on input, if present and if group-curlen is not 0, group-name specifies the group name
for which information is to be returned.
On output, if groupid is specified and group-curlen is set to 0, returns the group name
corresponding to the group ID specified.
group-name is passed, and returned, in the form of a case-sensitive string that is up to 32
alphanumeric characters long.
group-maxlen specifies the length of the string variable group-name in bytes.
This parameter pair is required if group-curlen is specified.
678 Guardian Procedure Calls (G)