rpc_ns_group_mbr_inq_begin(3) — Subroutines

NAME

rpc_ns_group_mbr_inq_begin - Creates an inquiry context for viewing group members

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_syntaxAn integer value that specifies the syntax of argument group_name. To use the syntax specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, provide the integer value rpc_c_ns_syntax_default.

group_nameSpecifies the name of the RPC group to view.

member_name_syntax
An integer value that specifies the syntax of return argument 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 the integer value rpc_c_ns_syntax_default.

Output

inquiry_contextReturns a name service handle for use with the rpc_ns_group_mbr_inq_next and rpc_ns_group_mbr_inq_done routines.

statusReturns the status code from this routine. This status code indicates whether the routine completed successfully or, if not, why not. The possible status codes and their meanings are as follows:

rpc_s_okSuccess.

rpc_s_incomplete_nameIncomplete name.

rpc_s_invalid_name_syntaxInvalid name syntax.

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.

Before calling the rpc_ns_group_mbr_inq_next routine, 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

None.

NOTE:

For this release, the RPC naming service (rpc_ns) routines are not implemented, nor is an independent naming service provided.

RETURN VALUES