Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (G)
Guardian Procedure Calls Reference Manual—522629-013
6-35
GROUP_GETINFO_ Procedure
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 group name or group ID 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 a
required parameter.
590 Bad parameter value. Either the value specified in
group-curlen is
greater than the value specified in
group-maxlen, the value specified in
group-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.
group-name:group-maxlen input, output:input
STRING .EXT:ref:*, INT:value
on input, if present and if
group-curlen is not 0, group-name specifies the
group name for which information is to be returned.
On output, if
groupid is specified and group-curlen is set to 0, returns the
group name corresponding to the group ID specified.
group-name is passed, and returned, in the form of a case-sensitive string that is
up to 32 alphanumeric characters long.
group-maxlen specifies the length of the string variable group-name in bytes.
This parameter pair is required if
group-curlen is specified.
group-curlen input, output
INT .EXT:ref:1
on input, if
group-name is specified, contains the actual length of group-name in
bytes. The default value is 0.
On output, if
group-name is returned, this parameter contains the actual length of
group-name in bytes.
This parameter is required if
group-name:group-maxlen is specified.
groupid input, output
INT(32) .EXT:ref:1