Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (G)

Guardian Procedure Calls Reference Manual—522629-013

6-37

GROUP_GETNEXT_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

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

Syntax for TAL Programmers

Parameters

error returned value

INT

returns a file-system error number indicating the outcome of the call. Common

errors returned are:

0 No error.

11 Record not in file. There are no more groups, or the specified group name

is undefined.

Note. In the TNS/E environment the CEXTDECS file uses the int data type for 32-bit values.

This is a change from the TNS and TNS/R environments where CEXTDECS uses the long

data type for 32-bit values.

#include <cextdecs(GROUP_GETNEXT_)>

short GROUP_GETNEXT_ ( [ char *group-name ]

,[ short group-maxlen ]

,[ short *group-curlen ]

,[ __int32_t *groupid ] );

error := GROUP_GETINFO_ ( group-name:group-maxlen ! i,o:i

,group-curlen ! i,o

,[ groupid ] ); ! o