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

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

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).