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

 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