PreviousNext

rpc_string_free(3rpc)

Frees a character string allocated by the runtime

Used by client, server, or management applications.

Synopsis

#include <dce/rpc.h>

void rpc_string_free(

unsigned_char_t **string,

unsigned32 *status);

Parameters

Input/Output

string
Specifies the address of the pointer to the character string to free.

The value NULL is returned.

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_string_free( ) routine deallocates the memory occupied by a character string returned by the RPC runtime.

An application must call this routine once for each character string allocated and returned by calls to other RPC runtime routines. The names of these routines appear at the end of this reference page.

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: dce_error_inq_text(3dce)

rpc_binding_inq_auth_client(3rpc)

rpc_binding_inq_auth_info(3rpc)

rpc_binding_to_string_binding(3rpc)

rpc_mgmt_ep_elt_inq_next(3rpc)

rpc_mgmt_inq_server_princ_name(3rpc)

rpc_ns_binding_inq_entry_name(3rpc)

rpc_ns_entry_expand_name(3rpc)

rpc_ns_group_mbr_inq_next(3rpc)

rpc_ns_profile_elt_inq_next(3rpc)

rpc_string_binding_compose(3rpc)

rpc_string_binding_parse(3rpc)

uuid_to_string(3rpc)