VMS Help DCE_RPC, Application Routines, rpc_binding_vector_free  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   rpc_binding_vector_free - 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.  The possible status codes and their meanings
       are as follows:

       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.

 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.

 RELATED INFORMATION

   Functions: rpc_binding_free
              rpc_ns_binding_lookup_next
              rpc_server_inq_bindings