Locate a named group in a Group List (QzhbFindGroupInList) API
In the IBM® HTTP Server for i, use the QzhbFindGroupInList() API to search an in-memory group list for a named group.
Required Parameter Group: | |||
1 | grplist | Input | Binary(4) |
2 | group | Input | Binary(4) |
3 | group_len | Input | Binary(4) |
4 | grp | 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.
- group
- INPUT:CHAR(*)
The group name for which the system will search the list . The group name is case-sensitive. Leading and trailing blanks are included with the name.
- group_len
- INPUT:BINARY(4)
The length of the group name string. The length must be greater than or equal to 1.
- grp
- OUTPUT:BINARY(4)
The group name handle returned if the named group was found in the list.
- 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.
- HTPA206 E
- Group file &1 not found in group list.