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

 NAME

   rpc_ns_group_mbr_add - Adds an entry name to a group; if necessary,
                          creates the entry

   Used by client, server, or management applications.

 SYNOPSIS

   #include <dce/rpc.h>

   void rpc_ns_group_mbr_add( unsigned32 group_name_syntax,
                              unsigned_char_t *group_name,
                              unsigned32 member_name_syntax,
                              unsigned_char_t *member_name,
                              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 RPC group that receives a new member.  This can be
       either the global or cell-relative name.

   member_name_syntax
       An integer value that specifies the syntax of member_name.
       To use the syntax specified in the RPC_DEFAULT_ENTRY_SYNTAX
       logical name, provide rpc_c_ns_syntax_default.

   member_name
       Name of the new RPC group member.  This can be either the global
       or cell-relative name.

   Output

   status
       Returns the status code from this routine, indicating 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_class_version_mismatch
                      RPC class version mismatch.

       rpc_s_incomplete_name
                      Incomplete name.

       rpc_s_invalid_name_syntax
                      Invalid name syntax.

       rpc_s_name_service_unavailable
                      Name service unavailable.

       rpc_s_no_ns_permission
                      No permission for name service operation.

       rpc_s_unsupported_name_syntax
                      Unsupported name syntax.

 DESCRIPTION

   The rpc_ns_group_mbr_add() routine adds, to the name service database,
   an entry name as a member to the Name Service Interface (NSI) group
   attribute of an entry.  The group_name parameter specifies the entry.

   If the specified group_name entry does not exist, this routine creates
   the entry with a group attribute and adds the group member specified
   by the member_name parameter. In this case, the application must have
   permission to create the entry. Otherwise, a management application
   with the necessary permissions creates the entry by calling
   rpc_ns_mgmt_entry_create() before the application is run.

   An application can add the entry in member_name to a group before it
   creates the entry itself.

   Permissions Required

   You need both read permission and write permission to the CDS object
   entry (the target group entry).  If the entry does not exist, you
   also need insert permission to the parent directory.

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_ns_group_mbr_remove
              rpc_ns_mgmt_entry_create