SUCCESS, or a negative value on error, in which case the error code is found in iserrno.
this call will delete the currently selected record.