PreviousNext

rpc_binding_vector_free(3rpc)

Frees the memory used to store a vector and binding handles

Used by client or server applications.

Synopsis

#include <dce/rpc.h>

void rpc_binding_vector_free(

rpc_binding_vector_t **binding_vector,

unsigned32 *status);

Parameters

Input/Output

binding_vector
Specifies the address of a pointer to a vector of server binding handles. On return the pointer is set to NULL.

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_vector_free( ) routine frees the memory used to store a vector of server binding handles. The freed memory includes both the binding handles and the vector itself.

A server obtains a vector of binding handles by calling rpc_server_inq_bindings( ). A client obtains a vector of binding handles by calling rpc_ns_binding_lookup_next( ). Call rpc_binding_vector_free( ) if you have used either of these routines.

The rpc_binding_free( ) routine frees individual elements of the vector. If an element is freed with this routine, the NULL element entry replaces it; rpc_binding_vector_free( ) ignores such an entry.

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_arg
Invalid argument.

rpc_s_invalid_binding
Invalid binding handle.

rpc_s_wrong_kind_of_binding
Wrong kind of binding for operation.

Related Information
Functions: rpc_binding_free(3rpc)

rpc_ns_binding_lookup_next(3rpc)

rpc_server_inq_bindings(3rpc)