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.
Add a new Group to the end of a Group List
(QzhbAddGroupToList) API
Required Parameter Group:
1 grplist Input Binary(4)
2 group Input Char(*)
3 group_len Input Binary(4)
4 grp Output Binary(4)
5 errcode I/O Char(*)
Threadsafe: Yes
Use the QzhbAddGroupToList API to add a new group to an in-memory group list.
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 to add to the list.
group_len
INPUT:BINARY(4)
The length of the group name. The length must be greater than or equal to 1.
grp
OUTPUT:BINARY(4)
The handle of the newly created group, or the handle of an existing group if
the named group already exists. Attempting to add a group that already exists
is not considered an error by the system.
errcode
I/O:CHAR(*)
The structure in which to return error information.
Chapter 2. Application Programming Interfaces 71