Guardian Programming Reference Summary for C

Functions Summary (G-N)
Guardian Programming Reference Summary for C—522630-001
6-4
GROUP_GETINFO_
Returns attributes of the specified group.
returned value:
is-auto-delete
GROUP_GETNEXT_
Returns a group name and group ID. On successive calls, all group names and group
IDs can be obtained.
#include <cextdecs(GIVE_BREAK)>
short GIVE_BREAK ( short { _near *common-fcb } /* i */
{ _near *file-fcb } );/* i */
#include <cextdecs(GROUP_GETINFO_)>
short GROUP_GETINFO_ ( [ char *group-name ] /* i */
,[ short group-maxlen ] /* o,i */
,[ short *group-curlen ] /* i,o */
,[ long *groupid ] /* i,o */
,[ short *is-auto-delete ] /* o */
,[ char *descrip ] /* o */
,[ short descrip-maxlen ] /* i */
,[ short *descriplen ] ); /* o */
0=No error.
11 = Record not in use. The specified group name or group ID is undefined.
22 = Parameter out of bounds. An input parameter is not within the valid range,
or return information does not fit into the length of the space provided, or an
output parameter overlays the stack marker that was created by calling this
procedure.
29 = This procedure was called without specifying a required parameter.
590 = Bad parameter value. Either the value specified in group-curlen is
greater than the value specified in group-maxlen, the value specified in
group-curlen is not within the valid range, or the value specified in
groupid is not within the valid range.
-1 = The group is deleted when it becomes empty.
0 = The group is not deleted when it becomes empty.