NAME

   rpc_cs_char_set_compat_check - 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 possible status codes and their meanings
       are as follows:

       rpc_s_ok

       rpc_s_ss_no_compat_charsets

   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.

 RELATED INFORMATION

   Functions: rpc_cs_eval_with_universal
              rpc_cs_eval_without_universal
              rpc_cs_get_tags
              rpc_ns_mgmt_read_codesets
              rpc_rgy_get_codesets