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

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 rpc_ns_mgmt_read_codesets() or rpc_rgy_get_codesets(). 

Output

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

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), rpc_rgy_get_codesets(3rpc).