NAME

rpc_ns_group_mbr_inq_begin- creates an inquiry context for viewing group members

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 argument group_name. (See Name Syntax Constants for the possible values of this argument.)

The value rpc_c_ns_syntax_default specifies the syntax specified by the RPC_DEFAULT_ENTRY_SYNTAX environment variable.

group_name

The name of the group to view. The group name syntax is identified by the argument group_name_syntax.

member_name_syntax

An integer value that specifies the syntax of return argument member_name for the rpc_ns_group_mbr_inq_next() routine. (See Name Syntax Constants for the possible values of this argument.)

The value rpc_c_ns_syntax_default specifies the syntax specified by the RPC_DEFAULT_ENTRY_SYNTAX environment variable.

Output

inquiry_context

Returns an inquiry context 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. 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_unsupported_name_syntax

Unsupported name syntax.

DESCRIPTION

The rpc_ns_group_mbr_inq_begin() routine creates an inquiry context for viewing the members of an RPC group.

The application calls this routine to create an inquiry context before calling the rpc_ns_group_mbr_inq_next() routine.

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

None.

RETURN VALUE

None.

SEE ALSO

rpc_ns_group_mbr_add()
rpc_ns_group_mbr_inq_done()
rpc_ns_group_mbr_inq_next()
rpc_ns_mgmt_handle_set_exp_age().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.