SYNOPSIS

PARAMETERS

Input

Specifies an inquiry context. The application obtains the inquiry context
by calling the rpc_ns_group_mbr_inq_begin() routine.

Output

member_name

Returns a pointer to an RPC group member name.

The syntax of the member_name argument depends on the value of
inquiry_context. The application specifies this syntax with the
member_name_syntax argument when it calls
rpc_ns_group_mbr_inq_begin() to obtain the inquiry context.

status

Returns the status code from this routine. The status code indicates
whether the routine completed successfully, or if not, why not.

Possible status codes and their meanings include:

rpc_s_ok

Success.

rpc_s_entry_not_found

Name service entry not found.

rpc_s_not_rpc_entry

Not an RPC entry.

rpc_s_class_version_mismatch

Name service entry has incompatible RPC class version.

rpc_s_name_service_unavailable

Name service unavailable.

rpc_s_no_more_members

No more members.

rpc_s_no_ns_permission

No permission for name service operation.

DESCRIPTION

The rpc_ns_group_mbr_inq_next() routine returns one member of the
RPC group specified by the group_name argument in the
rpc_ns_group_mbr_inq_begin() routine.

An application can view all the members of an RPC group by repeatedly
calling the rpc_ns_group_mbr_inq_next() routine. When all the
group members have been viewed, this routine returns an
rpc_s_no_more_members status. The group members are returned in
unspecified order.

On each call to this routine that returns a member name, the RPC
run-time system allocates memory for the returned member_name. The
application calls the rpc_string_free() routine for each returned
member_name string.

After viewing the RPC group's members, the application must call the
rpc_ns_group_mbr_inq_done() routine to delete the inquiry context.

Permissions Required

The application needs read permission to the target name service entry.