NAME

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

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 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 which the member is added. The group name syntax is identified by the argument group_name_syntax.

member_name_syntax

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

member_name

The name of the group member to add. The member name syntax is identified by the argument member_name_syntax.

Output

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_class_version_mismatch

Name service entry has incompatible RPC class version.

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 a group member to the group attribute of a name service 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.

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

Permissions Required

The application needs both read permission and write permission for the target name service entry. If the entry does not exist, the application also needs insert permission for the parent directory.

RETURN VALUE

None.

SEE ALSO

rpc_ns_group_mbr_remove()
rpc_ns_mgmt_entry_create().

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.