NAME

   rpc_ns_mgmt_remove_attribute - Removes an attribute from an RPC
                                  server entry in the name service
                                  database.

   Used mainly by server applications; can also be used by management
   applications.

 SYNOPSIS

   #include <dce/rpc.h>
   #include <dce/nsattrid.h>

   void rpc_ns_mgmt_remove_attribute( unsigned32 entry_name_syntax,
                                      unsigned_char_t *entry_name,
                                      uuid_t *attr_type,
                                      error_status_t *status );

 PARAMETERS

   Input

   entry_name_syntax
       An integer value that specifies the syntax of the
       entry_name parameter.  To use the syntax specified in
       the RPC_DEFAULT_ENTRY_SYNTAX logical name, provide
       rpc_c_ns_syntax_default.

   entry_name
       Specifies the name of the RPC server entry in the name service
       database from which the attribute will be removed. The name can be
       either the global or cell-relative name.  If you are using this
       routine to remove a code sets attribute from an RPC server entry
       in the Cell Directory Service database, then this parameter
       specifies the CDS name of the server entry that contains the code
       sets attribute to be removed.

   attr_type
       A UUID that specifies the attribute type. For DCE 1.1, this value
       must be rpc_c_attr_codesets.

   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
                      The routine cannot find the RPC server entry
                      specified in the call in the name service database.

       rpc_s_incomplete_name
                      The routine cannot expand the RPC server entry name
                      specified in the call.

       rpc_s_invalid_name_syntax
                      The name syntax specified in the call is not valid.

       rpc_s_mgmt_bad_type
                      The attribute type specified in the call does not
                      match that of the attribute to be removed from the
                      name service database.

       rpc_s_name_service_unavailable
                      The routine was unable to communicate with the name
                      service.

       rpc_s_no_ns_permission
                      The routine's caller does not have the proper
                      permission for an NSI operation.

 DESCRIPTION

   The rpc_ns_mgmt_remove_attribute() routine belongs to a set of DCE RPC
   routines for use by client and server applications that are
   transferring international character data in a heterogeneous character
   set and code sets environment.

   The rpc_ns_mgmt_remove_attribute() routine is designed to be a generic
   routine for removing an attribute from an RPC server entry in the name
   service database.  The routine removes the attribute from the
   specified RPC server entry in the name service database.  The routine
   does not remove the RPC server entry.

   For DCE 1.1, you use rpc_ns_mgmt_remove_attribute() in your
   application server initialization routine or signal handling routine
   to remove a code sets attribute from the server's entry in the Cell
   Directory Service database as part of the server cleanup procedure
   carried out prior to the server's termination.

   A management application can call rpc_ns_mgmt_remove_attribute() to
   remove an attribute from an RPC server entry in the name service
   database on behalf of an application that does not itself have the
   necessary name service permissions to remove one.

   Permissions Required

   You need write permission to the target RPC server entry (which is a
   CDS object).

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_ns_mgmt_read_codesets
              rpc_ns_mgmt_set_attribute
              rpc_rgy_get_codesets