Name

dced_objects_release - Releases the resources allocated for data read from a dced service

Synopsis

#include <dce/dced.h> void dced_objects_release(
dced_binding_handle_t dced_bh,
unsigned32 count,
void ∗data,
error_status_t ∗status);

Parameters

Input

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

countSpecifies the number of data items previously read and now to be released. 

Input/Output

dataSpecifies the data for which resources are released. 

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_objects_release() routine releases the resources allocated when data for dced is read.  Applications should call dced_objects_release() when finished with data allocated by the following dced API routines:

       •dced_object_read_all()

       •dced_object_read()

       •dced_hostdata_read()

If the data being released was read by using dced_object_read_all(), the count returned from this routine is used as input to the dced_objects_release() routine.  If the data being released was read by using dced_object_read() or dced_hostdata_read(), the count value required as input for the dced_objects_release() routine is 1. 

Examples

In the following example, a binding is created to a dced service on some host for a service that stores data, and the service’s entry list is obtained.  For each entry, the data is read, displayed, and released. 

dced_binding_handle_t   dced_bh;
dced_entry_list_t       entries;
unsigned32              i;
void                    ∗data;
error_status_t          status;
 dced_binding_create(host_service, dced_c_binding_syntax_default, &dced_bh, &status);
dced_list_get(dced_bh, &entries, &status);
for(i=0; i<entries.count; i++) {
   dced_object_read(dced_bh, &(entries.list[i].id), &data, &status);
   display(host_service, 1, &data);      /∗ application specific ∗/
   dced_objects_release(dced_bh, 1, data, &status);
   .
   .
   .

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

dced_s_bad_binding

dced_s_no_support

Related Information

Functions: dced_binding_create(3dce), dced_binding_from_rpc_binding(3dce), dced_hostdata_read(3dce), dced_object_read(3dce), dced_object_read_all(3dce). 

Books: OSF DCE Application Development Guide.