Guardian Procedure Calls Reference Manual

GROUP_GETNEXT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
The GROUP_GETNEXT_ procedure returns a group name and group ID. On successive calls, all
group names and group IDs can be obtained.
Syntax for C Programmers
#include <cextdecs(GROUP_GETNEXT_)>
short GROUP_GETNEXT_ ( char *group-name
,short group-maxlen
,short *group-curlen
,[ __int32_t *groupid ] );
Syntax for TAL Programmers
error := GROUP_GETNEXT_ ( group-name:group-maxlen ! i,o:i
,group-curlen ! i,o
,[ groupid ] ); ! o
Parameters
group-name:group-maxlen
input, output:input
STRING .EXT:ref:*, INT:value
on input, if group-curlen is not 0, group-name specifies a character string that precedes
the next group-name to be returned. group-maxlen specifies the length (in bytes) of the
string variable group-name. To obtain the first group name, set group-curlen to 0.
On output, this parameter returns the group name that follows the group-name specified as
the input parameter.
The group-name parameter is passed, and returned, in the form of a case-sensitive string that
is as many as 32 alphanumeric characters long.
group-curlen
input, output
INT .EXT:ref:1
on input, contains the actual length (in bytes) of group-name. To obtain the first group name,
set group-curlen to 0. The default value is 0.
On output, this parameter contains the actual length of group-name in bytes.
GROUP_GETNEXT_ Procedure 681