adoRSetState
 		Previous Topic  Next Topic 

Synopsis:

       adoRSetState(SetHandle)

Arguments:

       handle - The recordset handle.


Description:   This function is a utility function that returns the value of the State property of a recordset object.          This value can also be obtained by calling the adoRSetParmGet() function passing the P_RS_STATE constant to retrieve the value.


The returned value will be one of the adObjectState enumeration values as follows:


Constant

Value

Description

adStateClosed

0

Indicates that the object is closed.

adStateOpen

1

Indicates that the object is open.

adStateConnecting

2

Indicates that the object is connecting.

adStateExecuting

4

Indicates that the object is executing a command.

adStateFetching

8

Indicates that the rows of the object are being retrieved.


Returns:   Returns the value of the State  property of the recordset object,  or a negative error code.     If ADOERR_COMERR is returned, then the underlying ADO error can be obtained by calling adoLastError()