NAME

rpc_ns_group_mbr_inq_next — Returns one member name at a time from a group;  used by client, server, or management applications

Synopsis

void rpc_ns_group_mbr_inq_next(
rpc_ns_handle_t inquiry_context,
unsigned_char_t ∗∗member_name,
unsigned32 ∗status);

Parameters

Input

inquiry_context
Specifies a name service handle.  This handle is returned from the rpc_ns_group_mbr_inq_begin() routine. 

Output

member_name
Returns a pointer to a (global) RPC group member name. The syntax of the returned name is specified by the rpc_ns_group_mbr_inq_begin() routine parameter member_name_syntax. 

Specify NULL to prevent the routine from returning this parameter.  In this case, the application does not call rpc_string_free(). 

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

Description

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

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

On each call to this routine that returns a member name (as a global name), the RPC runtime allocates memory for the returned member_name.  The application calls  rpc_string_free() 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

You need read permission to the CDS object entry (the target group entry). 

Return Values

No value is returned. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

rpc_s_ok
Success.

rpc_s_class_version_mismatch
RPC class version mismatch.

rpc_s_entry_not_found
Name service entry not found.

rpc_s_invalid_ns_handle
Invalid name service handle.

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.

rpc_s_not_rpc_entry
Not an RPC entry.

Related Information

Functions: rpc_ns_group_mbr_inq_begin(3rpc), rpc_ns_group_mbr_inq_done(3rpc), rpc_string_free(3rpc).