Name

dced_list_release - Releases the resources for a list of entries of a dced service

Synopsis

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

Parameters

Input

dced_bhSpecifies the dced binding handle for a dced service on a specific host. 

InputOutput

listSpecifies a list of data entries for the service. 

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_list_release() routine releases the resources allocated for a list of data entries previously retrieved by the dced_list_get() routine. 

Prior to calling this routine, the application must have first established a valid dced binding handle by calling either the dced_binding_create() or dced_binding_from_rpc_binding() routine, and then the application must have called the dced_list_get() 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

Related Information

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

Books: OSF DCE Application Development Guide.