rpc_ns_mgmt_read_codesets- reads the code sets attribute associated with a server entry in the name service database
void rpc_ns_mgmt_read_codesets( unsigned32 entry_name_syntax, unsigned_char_t *entry_name, rpc_codeset_mgmt_p_t *code_sets_array, 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 to read the code sets attribute. The name can be either the global or cell-relative name.
- An integer array that specifies the code sets supported by the server. Each array element is an integer value that uniquely identifies one code set.
- 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 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_read_codesets() routine retrieves a server's supported code sets by reading the code sets attribute associated with the server's entry in the name service database, allowing a client to evaluate them against its own supported code sets. The routine is one of those used for character and code set interoperability, which permits clients and servers to transfer international character data in a heterogeneous character set and code sets environment.
Client applications that use the code set evaluation routines rpc_cs_eval_with_universal() and rpc_cs_eval_without_universal() do not need to call the rpc_ns_mgmt_read_codesets() routine explicitly, because these routines call it on the client's behalf. Further character and code set evaluation implementations may need to make use of the rpc_ns_mgmt_read_codesets() routine.
You need read 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.