Guardian Procedure Calls Reference Manual

USER_GETNEXT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
The USER_GETNEXT_ procedure returns the next user name or alias in the order in which it is
stored by the security mechanism in effect. On successive calls, all user names and aliases can be
obtained.
Syntax for C Programmers
#include <cextdecs(USER_GETNEXT_)>
short USER_GETNEXT_ ( char *user-name
,short user-maxlen
,short *user-curlen
,short *is-alias );
Syntax for TAL Programmers
error := USER_GETNEXT_ ( user-name:user-maxlen ! i,o:i
,user-curlen ! i,o
,is-alias ); ! i,o
Parameters
user-name:user-maxlen
input, output:input
STRING .EXT:ref:*, INT:value
on input, specifies a character string that precedes the next user-name to be returned.
user-maxlen specifies the length of the string variable user-name in bytes. To obtain the
first user name or alias, set user-curlen to 0.
On output, this parameter returns the user name or alias that follows the user-name specified
as the input parameter.
user-curlen
input, output
INT .EXT:ref:1
on input, if user-name is specified, contains the actual length of user-name in bytes. To
obtain the first user name or alias, set user-curlen to 0.
On output, returns the actual length of user-name in bytes.
1458 Guardian Procedure Calls (T-V)