Previous section.

CDE 1.1: Remote Procedure Call
Copyright © 1997 The Open Group

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.

Contents Next section Index