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

 NAME

   rpc_ns_profile_delete - Deletes a profile attribute

   Used by client, server, or management applications.

 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 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 name of the profile to delete.  This can be either
       the global or cell-relative name.

   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_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 (the profile_name
   parameter).

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

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

   Permissions Required

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

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_ns_profile_elt_add
              rpc_ns_profile_elt_remove