Retrieve the next User in the Group (QzhbGetNextUser) API
Required Parameter Group:
1 grplist Input Binary(4)
2 grp Input Binary(4)
3 prev_usr Input Binary(4)
5 usr Output Binary(4)
6 errcode I/O Char(*)
Threadsafe: Yes
Use the QzhbGetNextUser API to retrieve the next user from a group.
Authorities and locks
None.
Required parameter group
grplist
INPUT:BINARY(4)
The group list handle returned from a call to the QzhbCreateGroupList or
QzhbOpenGroupList API.
grp
INPUT:BINARY(4)
The group handle returned from a call to the QzhbGetNextGroup,
QzhbFindGroupInList, or QzhbAddGroupToList API.
prev_usr
INPUT:BINARY(4)
The user handle for an existing user that returns the user immediately
following this user. A handle of 0 returns the first user in the group list.
usr
OUTPUT:BINARY(4)
The handle of the user if a next user is found in the group. If no next user is
found, error HTPA207 is returned.
errcode
I/O:CHAR(*)
The structure in which to return error information.
Error messages
CPF3CF1 E
Error code parameter not valid.
HTPA001 E
Input parameter &1 not valid.
HTPA203 E
Input group list handle in parameter &1 not valid.
HTPA204 E
Input group handle in parameter &1 not valid.
Chapter 2. Application Programming Interfaces 73