VMS Help DCE_RPC, Application Routines, rpc_ns_mgmt_free_codesets  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   rpc_ns_mgmt_free_codesets - Frees a code sets array that has been
                               allocated by the RPC runtime

   Used by client and server applications.

 SYNOPSIS

   #include <dce/rpc.h>

   void rpc_ns_mgmt_free_codesets( rpc_codeset_mgmt_p_t *code_sets_array,
                                   error_status_t *status );

 PARAMETERS

   Input/Output

   code_sets_array
       A pointer to a code sets array that has been allocated by a
       call to the rpc_ns_mgmt_read_codesets() routine or the
       rpc_rgy_get_codesets() routine.

   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       Success.

 DESCRIPTION

   The rpc_ns_mgmt_free_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_free_codesets() routine frees from the client
   application's memory a code sets array allocated by a client call to
   the rpc_ns_mgmt_read_codesets() or the rpc_rgy_get_codesets() routines.
   The routine frees from a server application's memory a code sets array
   allocated by a server call to the rpc_rgy_get_codesets() routine.

   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. Clients and servers
   use the rpc_rgy_get_codesets() routine to get their supported code
   sets from the code set registery.  Clients and servers use the
   rpc_ns_mgmt_free_codesets() routine to free the memory allocated to
   the code sets array as part of their cleanup procedures.

   Permissions Required

   None.

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_ns_mgmt_read_codesets
              rpc_rgy_get_codesets