rpc_ns_mgmt_read_codesets(3rpc)
Reads the code sets attribute associated with an RPC server entry in the name service database.
Used by client applications.
Synopsis
#include <dce/rpc.h>
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);
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 to read the code sets attribute. The name can be either the global or
cell-relative name.
Output
code_sets_array
A code sets array that specifies the code sets that the RPC server supports.
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_read_codesets( ) routine belongs to a set of DCE RPC routines for character and code set interoperability. These routines permit client and
server applications to transfer international character data in a heterogeneous character set and code sets environment.
The rpc_ns_mgmt_read_codesets( ) routine reads the code sets attribute associated with an RPC server entry in the name service database. The routine takes the name of an RPC server entry and returns a code sets array that corresponds to the code sets that this RPC server supports.
Client applications use the rpc_ns_mgmt_read_codesets( ) routine to retrieve a server's supported code sets in order to evaluate them against the code sets that the client supports. Client applications that use the evaluation routines rpc_cs_eval_with_universal( ) and rpc_cs_eval_without_universal( ) do not need to call this routine explicitly, because these code sets evaluation routines call it on the client's behalf. Application developers who are writing their own character and code set evaluation routines may need to include rpc_ns_mgmt_read_codesets( ) in their user-written evaluation routines.
Permissions Required
You need read 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
rpc_s_invalid_name_syntax
rpc_s_mgmt_bad_type
rpc_s_name_service_unavailable
rpc_s_no_permission
rpc_s_incomplete_name
rpc_s_no_memory
Related Information
Functions: dce_cs_rgy_to_loc(3rpc)
rpc_ns_mgmt_free_codesets(3rpc)
rpc_ns_mgmt_remove_attribute(3rpc)
rpc_ns_mgmt_set_attribute(3rpc)