NAME

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

       rpc_s_ok      Success.

       rpc_s_invalid_binding
                     Invalid binding handle.

       rpc_s_wrong_kind_of_binding
                     Wrong kind of binding for operation.

 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.

 RELATED INFORMATION

   Functions: rpc_binding_copy
              rpc_binding_from_string_binding
              rpc_binding_vector_free
              rpc_ns_binding_import_next
              rpc_ns_binding_lookup_next
              rpc_ns_binding_select
              rpc_server_inq_bindings