Name

dce_db_free - Releases the data supplied from a backing store

Synopsis

#include <dce/dce.h>
#include <dce/dbif.h> void dce_db_free(
    dce_db_handle_t handle,
    void ∗data,
    error_status_t ∗status);

Parameters

Input

handleA handle, returned from dce_db_open(), that identifies the backing store being used. 

dataThe data area to be released. 

Output

statusA pointer to the completion status.  On successful completion, the routine returns error_status_ok.  Otherwise, it returns an error. 

Description

The dce_db_free() routine is designed to free the data area previously returned via a call to any of the routines dce_db_fetch(), dce_db_fetch_by_name(), or dce_db_fetch_by_uuid(). 

Notes

In the current implementation, the dce_db_free() routine does not perform any action.  For servers that execute properly, this is of little consequence because their allocated memory is automatically cleaned up when a remote procedure call finishes.  For completeness, and for compatibility with future releases, the use of dce_db_free() is recommended. 

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
The call was successful.

Related Information

Functions: dce_db_fetch(3dce), dce_db_fetch_by_name(3dce), dce_db_fetch_by_uuid(3dce).