Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (G)
Guardian Procedure Calls Reference Manual—522629-013
6-43
GROUPMEMBER_GETNEXT_ Procedure
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.
590 Bad parameter value. Either the value specified in
member-curlen is
greater than the value specified in
member-maxlen, the value specified
in
member-curlen is not within the valid range, or the value specified in
group-id is not within the valid range.
Refer to the
Guardian Procedure Errors and Messages Manual for more
information on file-system error messages.
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 of the string variable member-
name in bytes. 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.
member-name is passed, and returned, in one of two forms:
group name.user member
The group name and user member are each up to 8 alphanumeric
characters long, and the first character must be a letter. The group name
and user member are separated by a period (.).
alias
The alias is a case-sensitive string made up of 1 to 32 alphanumeric
characters, periods (.), hyphens (-), or underscores (_). The first character
must be alphanumeric.
member-curlen input, output
INT .EXT:ref:1
on input, if
member-name is specified, contains the actual length of member-name
in bytes. To obtain the first name, set
member-curlen to 0.
On output, this parameter returns the actual length of
member-name in bytes.