Name

dced_binding_free - Releases the resources associated with a dced binding handle

Synopsis

#include <dce/dced.h> void dced_binding_free(
dced_binding_handle_t dced_bh,
error_status_t ∗status);

Parameters

Input

dced_bhSpecifies a dced binding handle to free for a dced service on a specific host. 

Output

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not. 

Description

The dced_binding_free() routine frees resources used by a dced binding handle and referenced information.  Use this routine when your application is finished with a host service to break the communication between your application and the dced.  The dced binding handle and referenced information is created with the dced_binding_create() or dced_binding_from_rpc_binding() routine. 

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. 

error_status_ok

rpc_s_invalid_binding

rpc_s_wrong_kind_of_binding

Related Information

Functions: dced_binding_create(3dce), dced_binding_from_rpc_binding(3dce). 

Books: OSF DCE Application Development Guide.