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

   #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 logical name, 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.  The possible status codes and their meanings are as
       follows:

       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

 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.

 RELATED INFORMATION

   Functions: dce_cs_rgy_to_loc
              dce_cs_loc_to_rgy
              rpc_ns_mgmt_free_codesets
              rpc_ns_mgmt_remove_attribute
              rpc_ns_mgmt_set_attribute
              rpc_rgy_get_codesets
              rpc_rgy_get_max_bytes