adoRSetClose
Previous Topic  Next Topic 

Synopsis:

       adoRSetClose(handle)

Arguments:

       handle - The recordset handle.


Description:   This function closes the recordset specified by the handle argument and releases the underlying ADO _Recordset object.


Any attempt to use the handle in any other functions will result in an error.            


A task cannot close a recordset that has been opened privately by another task,  and any private recordsets that are still open when a task stops will be automatically closed and released.              


Note that care should be taken when closing public recordsets because the recordset handle  might be quickly reallocated to another recordset so any tasks making called to the original handle will then be referencing the wrong dataset, with unexpected results.


Returns:   Returns 0 upon success or a negative error code.   If ADOERR_COMERR is returned, then the underlying ADO error can be obtained by calling adoLastError()