rpc_cs_char_set_compat_check(3rpc)
Evaluates character set compatibility between a client and a server.
Used by client applications.
Synopsis
#include <dce/rpc.h>
void rpc_cs_char_set_compat_check(
unsigned32 client_rgy_code_set_value,
unsigned32 server_rgy_code_set_value,
error_status_t *status);
Parameters
Input
client_rgy_code_set_value
The registered hexadecimal value that uniquely identifies the code set that the client is using as its local code set.
server_rgy_code_set_value
The registered hexadecimal value that uniquely identifies the code set that the server is using as its local code set.
Output
status
Returns the status code from this routine. This status code indicates whether the routine completed successfully or, if not, why not. The routine can also return status
codes from the dce_cs_rgy_to_loc( ) routine.
Description
The rpc_cs_char_set_compat_check( ) 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_cs_char_set_compat_check( ) routine provides a method for determining character set compatibility between a client and a server; if the server's character set is incompatible with that of the client, then connecting to that server is most likely not acceptable, since massive data loss would result from such a connection.
The RPC routines that perform character and code sets evaluation use the rpc_cs_char_set_compat_check( ) routine in their character sets and code sets compatibility checking procedure. The routine takes the registered integer values that represent the code sets that the client and server are currently using and calls the code set registry to obtain the registered values that represent the character set(s) that the specified code sets support. If both client and server support just one character set, the routine compares client and server registered character set values to determine whether or not the sets are compatible. If they are not, the routine returns the status message rpc_s_ss_no_compat_charsets.
If the client and server support multiple character sets, the routine determines whether at least two of the sets are compatible. If two or more sets match, the routine considers the character sets compatible, and returns a success status code to the caller.
Client and server applications that use the DCE RPC code sets evaluation routines rpc_cs_eval_with_universal( ) and rpc_cs_eval_without_universal( ) do not need to call this routine explicitly because these DCE RPC routines call it on their behalf.
Client applications that do not use the DCE RPC code sets evaluation routines can use the rpc_cs_char_set_compat_check( ) routine in their code sets evaluation code as part of their procedure for determining character and code set compatibility with a server.
Permissions Required
No permissions are required.
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_ss_no_compat_charsets
Related Information
Functions: rpc_cs_eval_with_universal(3rpc)
rpc_cs_eval_without_universal(3rpc)
rpc_ns_mgmt_read_codesets(3rpc)