NAME

rpc_ns_profile_delete — Deletes a profile attribute;  used by client, server, or management applications

Synopsis

void rpc_ns_profile_delete(
unsigned32 profile_name_syntax,
unsigned_char_t ∗profile_name,
unsigned32 ∗status);

Parameters

Input

profile_name_syntax
An integer value that specifies the syntax of the profile_name parameter.  To use the syntax that is specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, provide rpc_c_ns_syntax_default. 

profile_name
Specifies the name of the profile to delete. 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. 

Description

The rpc_ns_profile_delete() routine deletes the profile attribute from the specified entry in the name service database (the profile_name parameter). 

Neither the specified entry nor the entry names included as members in each profile element are deleted. 

Use this routine cautiously; deleting a profile may break a hierarchy of profiles. 

Permissions Required

You need write permission to the CDS object entry (the target profile entry). 

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_not_found
Name service entry not found.

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_profile_elt_add(3rpc), rpc_ns_profile_elt_remove(3rpc).