NAME

rpc_ns_mgmt_entry_create- creates an entry in the name service database

SYNOPSIS

#include <dce/rpc.h>

void rpc_ns_mgmt_entry_create(
	unsigned32 entry_name_syntax,
	unsigned_char_t *entry_name,
	unsigned32 *status);

PARAMETERS

Input

entry_name_syntax

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

entry_name

The name of the entry to create. The entry name syntax is identified by the argument entry_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_entry_already_exists

Name service entry already exists.

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_mgmt_entry_create() routine creates an entry in the name service database.

A management application can call rpc_ns_mgmt_entry_create() to create an entry in the name service database for use by another application that does not itself have the necessary name service permissions to create an entry.

Permissions Required

The application that calls rpc_ns_mgmt_entry_create() needs insert permission for the parent directory. In order to modify the entry, the application for which it was created needs both read permission and write permission.

RETURN VALUE

None.

SEE ALSO

.rpc_ns_mgmt_entry_delete()

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.