PreviousNext

rpc_binding_free(3rpc)

Releases binding handle resources

Used by client or server applications.

Synopsis

#include <dce/rpc.h>

void rpc_binding_free

rpc_binding_handle_t *binding,

unsigned32 *status);

Parameters

Input/Output

binding
Specifies the server binding handle to free.

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_binding_free( ) routine frees the memory used by a server binding handle and its referenced binding information. Use this routine when your application is finished using a server binding handle that was dynamically created during program execution.

If the free-binding operation succeeds, the binding parameter returns the value NULL.

An application can dynamically create binding handles by calling any of the following routines:
rpc_binding_copy( )
rpc_binding_from_string_binding( )
rpc_ns_binding_import_next( )
rpc_ns_binding_select( )
rpc_server_inq_bindings( )

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.

rpc_s_invalid_binding
Invalid binding handle.

rpc_s_wrong_kind_of_binding
Wrong kind of binding for operation.

Related Information
Functions: rpc_binding_copy(3rpc)

rpc_binding_from_string_binding(3rpc)

rpc_binding_vector_free(3rpc)

rpc_ns_binding_import_next(3rpc)

rpc_ns_binding_lookup_next(3rpc)

rpc_ns_binding_select(3rpc)

rpc_server_inq_bindings(3rpc)