Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-47
USER_GETNEXT_ Procedure
USER_GETNEXT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
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
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. The specified
user-name 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 Missing parameter. This procedure was called without specifying all
parameters.
#include <cextdecs(USER_GETNEXT_)>
short USER_GETNEXT_ ( [ char *user-name ]
,[ short user-maxlen ]
,[ short *user-curlen ]
,[ short *is-alias ] );
error := USER_GETNEXT_ ( user-name:user-maxlen ! i,o:i
,user-curlen ! i,o
,is-alias ); ! i,o