PreviousNext

dced_binding_free(3dce)

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_bh
Specifies a dced binding handle to free for a dced service on a specific host.

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 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
Routines: dced_binding_create(3dce)

dced_binding_from_rpc_binding(3dce)

Book: OSF DCE Application Development Guide - Core Components