rpc_ns_group_mbr_inq_begin(3rpc)

Used by client, server, or management applications.

Synopsis

#include <dce/rpc.h>

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 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 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 rpc_ns_group_mbr_inq_next( ) and rpc_ns_group_mbr_inq_done( ) routines.

status
Returns 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)