rpc_ns_mgmt_remove_attribute- removes an attribute from a server entry in the name service database
#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);
- An integer value that specifies the syntax of the entry_name argument. To use the syntax that is specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, specify rpc_c_ns_syntax_default.
- Specifies the name of the 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. When this routine is used to remove a code sets attribute from a server entry in the Cell Directory Service (CDS) database, then this argument specifies the CDS name of the server entry from which the code sets attribute is to be removed.
- A UUID that specifies the attribute type. This value must be rpc_c_attr_codesets.
- Returns the status code from this routine. This status code indicates whether the routine completed successfully or, if not, why not.
Possible status codes and their meanings include:
The attribute type specified in the call does not match that of the attribute to be added to the name service database.
The routine was unable to communicate with the name service.
The name specified in the call cannot be expanded.
The name syntax specified in the call is not valid.
The specified name service entry was not found.
The routine was unable to allocate memory to encode the value.
The routine's caller does not have the proper permission for an NSI operation.
The rpc_ns_mgmt_remove_attribute() routine removes the attribute of the specified type from a server entry in the name servuce database. It is particularly useful in establishing character and code set interoperability, which permits clients and servers to transfer international character data in a heterogeneous character set and code sets environment.
For DCE 1.1, you use The rpc_ns_mgmt_remove_attribute() routine can be used in an application's server initialization or signal-handling routine to remove a code sets attribute from the server's entry in the CDS database as part of the server cleanup procedure carried out prior to the server's termination.
A management application can call the rpc_ns_mgmt_remove_attribute() routine to remove an attribute from a 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.
You need write permission to the target server entry in the name service.
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.