Retrieve the Name of a Group (QzhbGetGroupName) API
In the IBM® HTTP Server for i, use the QzhbGetGroupName() API to retrieve the name of a group using the group handle.
| Required Parameter Group: | |||
| 1 | grplist | Input | Binary(4) |
| 2 | grp | Input | Binary(4) |
| 3 | buf | Output | Char(*) |
| 4 | buf_len | Input | Binary(4) |
| 5 | buf_actlen | 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.
- buf
- OUTPUT:BINARY(4)
The buffer to receive the group name.
- buf_len
- OUTPUT:BINARY(4)
The size of the buffer.
- buf_actlen
- OUTPUT:BINARY(4)
The actual length of the group name. If the buf_actlen value is greater than the buf_len value, the data is truncated.
- 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.