NAME

rpc_cs_char_set_compat_check- evaluates character set compatibility between a client and a server

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.

Possible status codes and their meanings include:

rpc_s_ok

Success.

rpc_s_ss_no_compat_charsets

Character sets are not compatible.

The routine can also return status codes from the dce_cs_rgy_to_loc() routine.

DESCRIPTION

The rpc_cs_char_set_compat_check() routine is used to determine character set compatibility between a client and a server. Incompatibility, in almost all cases, renders a connection between the two unacceptable when international character data is to be transferred. 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.

The rpc_cs_char_set_compat_check() routine calls the code set registry to obtain the registered values that represent the character set(s) that each 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.

Because the rpc_cs_eval_with_universal() and rpc_cs_eval_without_universal() routines automatically call the rpc_cs_char_set_compat_check() routine, client applications that use them do not need to call it explicitly. Further code set evaluation implementations, however, can call the rpc_cs_char_set_compat_check() routine as part of their procedure for determining character and code set compatibility between a client and a server.

Permissions Required

None.

RETURN VALUE

None.

SEE ALSO

rpc_cs_eval_with_universal()
rpc_cs_eval_without_universal()
rpc_cs_get_tags()
rpc_ns_mgmt_read_codesets()
rpc_rgy_get_codesets().

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.