VMS Help DCE, dce_intro, dce_db_intro, dce_db_free  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 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
              dce_db_fetch_by_name
              dce_db_fetch_by_uuid