Add a new user to the end of a Group (QzhbAddUserToGroup) API
In the IBM® HTTP Server for i, use the QzhbAddUserToGroup() API to add a new user to an in-memory group.
| 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 to be added to the group.
- 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 newly created user, or the handle of an existing user if the named user already exists in the group. Attempting to add a user that already exists is not considered an error by the system.
- 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.