Retrieve the Name of a User (QzhbGetUserString) API
In the IBM® HTTP Server for i, use the QzhbGetUserString() API to retrieve the name string of a group member given the user handle, as returned by the QzhbGetNextUser(), QzhbFindUserInGroup(), or QzhbAddUserToGroup() API.
Required Parameter Group: | |||
1 | grplist | Input | Binary(4) |
2 | grp | Input | Binary(4) |
3 | usr | Input | Binary(4) |
4 | buf | Output | Char(*) |
5 | buf_len | Input | Binary(4) |
6 | buf_actlen | Output | Binary(4) |
7 | 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.
- usr
- INPUT:BINARY(4)
The user handle returned from a call to the QzhbGetNextUser(), QzhbFindUserInGroup(), or QzhbAddUserToGroup() API.
- buf
- OUTPUT:CHAR(*)
The buffer to receive the user string.
- buf_len
- INPUT:BINARY(4)
The size of the buffer.
- buf_actlen
- OUTPUT:BINARY(4)
The actual length of the user string. If the buf_actlen value is greater than the buf_len value, the data is truncated 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.
- HTPA205 E
- Input group handle in parameter &1 not valid.