rpc_ns_profile_delete(3rpc)

Used by client, server, or management applications.

Synopsis

#include <dce/rpc.h>

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

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