VMS Help DCE_RPC, Application Routines, rpc_ns_group_mbr_inq_begin  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 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_syntax
       An integer value that specifies the syntax of the group_name
       parameter.  To use the syntax specified in the
       RPC_DEFAULT_ENTRY_SYNTAX logical name, 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
       logical name, 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.  The possible status codes and their meanings are as
       follows:

       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.

 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.

 RELATED INFORMATION

   Functions: rpc_ns_group_mbr_add
              rpc_ns_group_mbr_inq_done
              rpc_ns_group_mbr_inq_next
              rpc_ns_mgmt_handle_set_exp_age