Guardian Procedure Calls Reference Manual

GROUPMEMBER_GETNEXT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
The GROUPMEMBER_GETNEXT_ procedure returns a user member or alias associated with a
group ID. On successive calls, all user members and aliases associated with a given group ID can
be obtained.
Syntax for C Programmers
#include <cextdecs(GROUPMEMBER_GETNEXT_)>
short GROUPMEMBER_GETNEXT_ ( __int32_t groupid
,char *member-name
,short member-maxlen
,short *member-curlen );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
error := GROUPMEMBER_GETNEXT_ ( groupid ! i
,member-name:member-maxlen ! i,o:i
,member-curlen ); ! i,o
Parameters
groupid
input
INT(32):value
specifies the group ID whose associated user member or alias is to be returned. The group ID
is a value in the range 0 through 65535.
member-name:member-maxlen
input, output:input
STRING .EXT:ref:*, INT:value
on input, specifies a character string that precedes the next member-name to be returned.
member-maxlen specifies the length (in bytes) of the string variable member-name. To obtain
the first user member or alias, set member-curlen to 0.
On output, this parameter returns the user member or alias that follows the member-name
specified as the input parameter.
GROUPMEMBER_GETNEXT_ Procedure 685