Retrieve the next User in the Group (QzhbGetNextUser) API
In the IBM® HTTP Server for i, use the QzhbGetNextUser() API to retrieve the next user from a group.
| Required Parameter Group: | |||
| 1 | grplist | Input | Binary(4) |
| 2 | grp | Input | Binary(4) |
| 3 | prev_usr | Input | Binary(4) |
| 4 | usr | Output | Binary(4) |
| 5 | errcode | I/O | Char(*) |
| Threadsafe: Yes | |||
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.
- HTPA205 E
- Input user handle in parameter &1 not valid.
- HTPA207 E
- User &1 not found in group.