Locate a User in a Group (QzhbFindUserInGroup) API
In the IBM® HTTP Server for i, use the QzhbFindUserInGroup() API to search an in-memory group for a specific user.
| Required Parameter Group: | |||
| 1 | grplist | Input | Binary(4) |
| 2 | grp | Input | Binary(4) |
| 3 | user | Input | Char(*) |
| 4 | user_len | Input | Binary(4) |
| 5 | usr | Output | Binary(4) |
| 6 | 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.
- user
- INPUT:CHAR(*)
The user name for which the system will search the group . The user name is case-sensitive. Leading and trailing blanks are included with the name.
- user_len
- INPUT:BINARY(4)
The length of the user string. The length must be greater than or equal to 1.
- usr
- OUTPUT:BINARY(4)
The handle of the user if it was found in the group.
- errcode
- I/O:CHAR(*)
The structure in which to return error information.
Error messages
- CPF3CF1 E
- Error code parameter not valid.
- CPF3C1D E
- Input variable length in parameter &1 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.
- HTPA207 E
- User &1 not found in group.