NAME

rpc_ns_mgmt_entry_create - Creates an entry in the name service database

Used by management applications. 

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_syntaxAn integer value that specifies the syntax of argument entry_name.  To use the syntax specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, provide the integer value rpc_c_ns_syntax_default. 

entry_nameSpecifies the name of the entry to create.  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_entry_already_existsName service entry already exists. 

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_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

You need both read permission and write permission to the CDS object entry (the target name service entry).  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_ns_mgmt_entry_delete(3)