NAME

rpc_ns_profile_elt_remove - Removes an element from a profile

Used by client, server, or management applications. 

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_syntaxAn integer value that specifies the syntax of argument profile_name.  To use the syntax specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, provide the integer value rpc_c_ns_syntax_default. 

profile_nameSpecifies the profile from which to remove an element.  This can be either the global or cell-relative name. 

if_idSpecifies the interface identifier of the profile element to be removed.  Specify NULL to remove the default profile member. 

member_name_syntax
An integer value that specifies the syntax of argument member_name.  To use the syntax specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, provide the integer value rpc_c_ns_syntax_default. 

member_nameSpecifies the name service entry name in the profile element to remove.  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.  The possible status codes and their meanings are as follows:

rpc_s_okSuccess. 

rpc_s_entry_not_foundName service entry not found. 

rpc_s_incomplete_nameIncomplete name. 

rpc_s_invalid_name_syntaxInvalid name syntax. 

rpc_s_name_service_unavailable
Name service unavailable.

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

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

Permissions Required

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

NOTE:

For this release, the RPC naming service (rpc_ns) routines are not implemented, nor is an independent naming service provided. 

RETURN VALUES

None. 

RELATED INFORMATION

Functions: rpc_ns_profile_delete(3), rpc_ns_profile_elt_add(3)