Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-43
USER_GETINFO_ Procedure
user-name:user-maxlen input, output:input
STRING .EXT:ref:*, INT:value
on input, if present and if
user-curlen is not 0, specifies the user name or alias
for which the default information is to be returned.
On output, if
user-id is specified, this parameter returns the corresponding user
name; otherwise, it remains unchanged from input.
user-name is passed, and returned, in one of two forms:
groupname.membername
The group name and member name are each up to 8 alphanumeric
characters long, and the first character must be a letter. The group
name and member name are separated by a period (.).
alias
The alias is a case-sensitive string made up of 1 through 32
alphanumeric characters, periods (.), hyphens (-), or underscores (_).
The first character must be alphanumeric.
The
user-maxlen parameter specifies the length of the string variable user-
name in bytes.
This parameter pair is required if
user-curlen is specified.
user-curlen input, output
INT .EXT:ref:1
on input, if
user-name is specified, contains the actual length of user-name in
bytes. A value of 0 indicates that
user-name is treated as an output parameter
and
user-id is treated as an input parameter. The default value is 0.
On output, if
user-name is returned, this parameter contains the actual length in
bytes.
This parameter is required if
user-name:user-maxlen is specified.
user-id input, output
INT(32) .EXT:ref:1
on input, if
user-curlen is 0 or omitted, specifies the user ID for which the
default information is to be returned.
On output, this parameter returns the user ID corresponding to the specified
user-name.
The user ID is a value in the range 0 through 65,535, where the low-order two
bytes, that is, the third and fourth bytes from the left, identify the group and the
member respectively.