NAME

rpc_ns_profile_elt_remove- removes an element from a profile

SYNOPSIS

#include <dce/rpc.h>

void rpc_ns_profile_elt_remove(
	unsigned32 profile_name_syntax,
	unsigned_char_t *profile_name,
	rpc_if_id_t *if_id,
	unsigned32 member_name_syntax,
	unsigned_char_t *member_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 from which an element is removed. The profile name syntax is identified by the argument profile_name_syntax.

if_id

Specifies the interface identifier of the profile element to be removed.

The application specifies NULL to remove the default profile member.

member_name_syntax

An integer value that specifies the syntax of argument member_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.

member_name

Specifies the name service entry to remove from the profile. The member name syntax is identified by the argument member_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_profile_element_not_found

Profile element not found.

rpc_s_unsupported_name_syntax

Unsupported name syntax.

DESCRIPTION

The rpc_ns_profile_elt_remove() routine removes a profile element from the profile attribute in the profile_name entry. Note that the member_name argument and the if_id argument must match exactly for an element to be removed.

The entry (member_name) referred to as a member in the profile element is not deleted.

Note:

Use this routine cautiously. Removing elements from a profile may break a hierarchy of profiles.

Permissions Required

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

RETURN VALUE

None.

SEE ALSO

rpc_ns_profile_delete()
rpc_ns_profile_elt_add().

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.