dced_objects_release(3dce)
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_bh
Specifies the dced binding handle for a dced service on a specific host.
count
Specifies the number of data items previously read and now to be released.
Input/Output
data
Specifies the data for which resources are released.
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_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
Routines: dced_object_read(3dce)
dced_binding_from_rpc_binding(3dce)
Book: OSF DCE Application Development Guide - Core Components