rpc_ns_mgmt_remove_attribute(3rpc)
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 environment variable, 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.
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.
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
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.
Related Information
Functions: rpc_ns_mgmt_read_codesets(3rpc)
rpc_ns_mgmt_set_attribute(3rpc)