rpc_ns_profile_elt_remove(3rpc)
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_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 profile from which to remove an element. This can be either the global or cell-relative name.
if_id
Specifies 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 member_name. To use the syntax specified in the RPC_DEFAULT_ENTRY_SYNTAX environment
variable, provide rpc_c_ns_syntax_default.
member_name
Specifies the name service entry name in the profile element to remove. This can be either the global or cell-relative name. When if_id is NULL,
this argument is ignored.
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_elt_remove( ) routine removes a profile element from the profile specified by profile_name. Unless if_id is
NULL, the member_name parameter and the if_id parameter must match the corresponding profile element attributes exactly for an element to be removed. When if_id
is NULL, the default profile element is removed, and the member_name argument is ignored.
The routine removes the reference to the entry specified by member_name from the profile; it does not delete the entry itself.
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).
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_profile_element_not_found
Profile element not found.
rpc_s_unsupported_name_syntax
Unsupported name syntax.
Related Information
Functions: rpc_ns_profile_delete(3rpc)