NAME

rpc_string_free- frees a character string allocated by the run-time system

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. The status code indicates whether the routine completed successfully, or if not, why not.

Possible status codes and their meanings include:

rpc_s_ok

Success.

DESCRIPTION

The rpc_string_free() routine deallocates the memory occupied by a character string when it was allocated with one of the following routines:

 

dce_error_inq_text()
rpc_binding_inq_auth_caller()
rpc_binding_inq_auth_info()
rpc_binding_to_string_binding()
rpc_mgmt_ep_elt_inq_next()
rpc_mgmt_inq_server_princ_name()
rpc_ns_binding_inq_entry_name()
rpc_ns_entry_expand_name()
rpc_ns_group_mbr_inq_next()
rpc_ns_profile_elt_inq_next()
rpc_string_binding_compose()
rpc_string_binding_parse()
uuid_to_string()

An application must call this routine once for each character string allocated and returned by calls to other RPC run-time routines.

RETURN VALUE

None.

SEE ALSO

tagmref_dce_error_inq_text
rpc_binding_inq_auth_caller()
rpc_binding_inq_auth_info()
rpc_binding_to_string_binding()
rpc_mgmt_ep_elt_inq_next()
rpc_mgmt_inq_server_princ_name()
rpc_ns_binding_inq_entry_name()
rpc_ns_entry_expand_name()
rpc_ns_group_mbr_inq_next()
rpc_ns_profile_elt_inq_next()
rpc_string_binding_compose()
rpc_string_binding_parse()
uuid_to_string().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.