dce_db_free(3dce)
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
handle
A handle, returned from dce_db_open( ), that identifies the backing store being used.
data
The data area to be released.
Output
status
A 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 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)