VMS Help DCE_RPC, Application Routines, rpc_ns_profile_elt_remove  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 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_syntax
       An integer value that specifies the syntax of the
       profile_name parameter.  To use the syntax specified
       in the RPC_DEFAULT_ENTRY_SYNTAX logical name, 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 logical
       name, 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.  The possible status codes and their meanings are as
       follows:

       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.

 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.

 RELATED INFORMATION

   Functions: rpc_ns_profile_delete
              rpc_ns_profile_elt_add