NAME

rpc_ns_group_mbr_inq_begin — Creates an inquiry context for viewing group members;  used by client, server, or management applications

Synopsis

void rpc_ns_group_mbr_inq_begin(
unsigned32 group_name_syntax,
unsigned_char_t ∗group_name,
unsigned32 member_name_syntax,
rpc_ns_handle_t ∗inquiry_context,
unsigned32 ∗status);

Parameters

Input

group_name_syntax
An integer value that specifies the syntax of the group_name parameter.  To use the syntax that is specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, provide rpc_c_ns_syntax_default. 

group_name
Specifies the name of the RPC group to view.

member_name_syntax
An integer value that specifies the syntax of member_name in the rpc_ns_group_mbr_inq_next() routine. 

To use the syntax that is specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, provide rpc_c_ns_syntax_default. 

Output

inquiry_context
Returns a name service handle for use with the following routines:

   •rpc_ns_group_mbr_inq_next()

   •rpc_ns_group_mbr_inq_done()

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_begin() routine creates an inquiry context for viewing the members of an RPC group. 

Before calling rpc_ns_group_mbr_inq_next(), the application must first call this routine to create an inquiry context. 

When finished viewing the RPC group members, the application calls the rpc_ns_group_mbr_inq_done() routine to delete the inquiry context. 

Permissions Required

No permissions are required. 

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_incomplete_name
Incomplete name.

rpc_s_invalid_name_syntax
Invalid name syntax.

rpc_s_unsupported_name_syntax
Unsupported name syntax.

Related Information

Functions: rpc_ns_group_mbr_add(3rpc), rpc_ns_group_mbr_inq_done(3rpc), rpc_ns_group_mbr_inq_next(3rpc), rpc_ns_mgmt_handle_set_exp_age(3rpc).