Retrieve the Name of a User (QzhbGetUserString) API

Important: Information for this topic supports the latest PTF levels for HTTP Server for i5/OS . It is recommended that you install the latest PTFs to upgrade to the latest level of the HTTP Server for i5/OS. Some of the topics documented here are not available prior to this update. See http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm Link outside Information Center

for more information.

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

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.

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.