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_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 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 argument member_name.  To use the syntax specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, provide the integer value rpc_c_ns_syntax_default. 

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

Output

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_name_service_unavailable
Name service unavailable.

rpc_s_no_ns_permissionNo 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 argument 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 argument. 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 the rpc_ns_mgmt_entry_create routine before the application is run. 

An application can add the entry in argument 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. 

NOTE:

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

RETURN VALUES

None. 

RELATED INFORMATION

Functions: rpc_group_member_remove(3), rpc_ns_mgmt_create_entry(3)