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_syntax
       An integer value that specifies the syntax of the entry_name
       parameter.  To use the syntax specified in the
       RPC_DEFAULT_ENTRY_SYNTAX logical name, provide
       rpc_c_ns_syntax_default.

   entry_name
       Specifies the name of the entry to create.  This can be either
       the global or cell-relative name.

   Output

   status
       Returns 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_ok       Success.

       rpc_s_entry_already_exists
                      Name service entry already exists.

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

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_ns_mgmt_entry_delete