NAME

rpc_ns_mgmt_read_codesets — Reads the code sets attribute associated with an RPC server entry in the name service database;  used by client applications

Synopsis

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 that is 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.

statusReturns 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), dce_cs_loc_to_rgy(3rpc), rpc_ns_mgmt_free_codesets(3rpc), rpc_ns_mgmt_remove_attribute(3rpc), rpc_ns_mgmt_set_attribute(3rpc), rpc_rgy_get_codesets(3rpc), rpc_rgy_get_max_bytes(3rpc).