Guardian Programming Reference Summary for C
Functions Summary (R-Z)
Guardian Programming Reference Summary for C—522630-001
8-37
where the legitimate fields are encoded with numbers that represent the following
information:
USER_GETNEXT_
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.
error
Bits 7-9 write
Bits 10-12 execute
Bits 13-15 purge
0 A (any local user)
1 G (any local group member)
2 O (only the local owner)
3 not used
4 N (any network user)
5 C (any network group/community user)
6 U (only the network owner)
7 - (only the local super ID)
#include <cextdecs(USER_GETNEXT_)>
short USER_GETNEXT_ ( [ char *user-name ] /* i */
,[ short user-maxlen ] /* o:i */
,[ short *user-curlen ] /* i,o */
,[ short *is-alias ] ); /* i,o */
0 No error.
11 Record not in use. 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 the
parameters.
590 Bad parameter value. Either the value specified in user-curlen is greater
than the value specified in user-maxlen or the value specified in user-
curlen is not within the valid range.