PreviousNext

rpc_ns_mgmt_entry_create(3rpc)

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 environment variable, 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.

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.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

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.

Related Information
Functions: rpc_ns_mgmt_entry_delete(3rpc)