rpc_ns_mgmt_free_codesets(3rpc)
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.
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 registry. 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.
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
Success.
Related Information
Functions: rpc_ns_mgmt_read_codesets(3rpc)