NAME

rpc_ns_profile_delete- deletes a profile attribute

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 argument profile_name. (See Name Syntax Constants for the possible values of this argument.)

The value rpc_c_ns_syntax_default specifies the syntax specified by the RPC_DEFAULT_ENTRY_SYNTAX environment variable.

profile_name

The name of the profile to delete. The profile name syntax is identified by the argument profile_name_syntax.

Output

status

Returns the status code from this routine. The status code indicates whether the routine completed successfully, or if not, why not.

Possible status codes and their meanings include:

rpc_s_ok

Success.

rpc_s_entry_not_found

Name service entry not found.

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_profile_delete() routine deletes the profile attribute from the specified entry in the name service database.

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

Note:

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

Permissions Required

The application needs write permission to the target name service profile entry.

RETURN VALUE

None.

SEE ALSO

rpc_ns_profile_elt_add()
rpc_ns_profile_elt_remove().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.