PRB: ADO Error -2147217896 when Calling MoveFirst() (174225)



The information in this article applies to:

  • ActiveX Data Objects (ADO) 1.0
  • ActiveX Data Objects (ADO) 1.5
  • ActiveX Data Objects (ADO) 2.0
  • ActiveX Data Objects (ADO) 2.01
  • ActiveX Data Objects (ADO) 2.1
  • ActiveX Data Objects (ADO) 2.1 SP2

This article was previously published under Q174225

SYMPTOMS

Performing a parameterized query such as "Select EmployeeID, FirstName, LastName from Employees where FirstName = ?" and calling the MoveFirst() method of the recordset, may cause the following error:

HRESULT = -2147217896 (0x80040E18) The rowset was built over a live data feed and cannot be restarted
This error occurs when using the ODBC Provider for OLE DB.

CAUSE

The error can be misleading, but the recordset most likely has a forward-only cursor.

The default cursor type for a recordset returned from a Command Execute() or from the Open()method of a recordset is forward only.

Since it is a forward-only cursor, in order to move backwards (as required by a MoveFirst command), ADO re-executes the query and then moves to the requested record.

When you set up Parameters in the Parameters collection of the Command object and then call Execute, ADO no longer considers the parameters valid after the Execute. Without valid parameters, the command cannot be re- executed to perform the MoveFirst and the error occurs.

RESOLUTION

Three possible solutions follow:
  • Do not call MoveFirst or MovePrevious on this type of recordset. MoveNext works as expected.
  • Instead of using parameters, build up a query string with concatenation (as in the example below) and use the non-parameterized string as the CommandText of the Command Object:
       'STRSQL = "Select EmployeeID, FirstName,
        LastName from Employees where Firstname = '" + fname + "'"'
    					

    NOTE: The error appears only with parameterized queries.

  • Change the cursor type of the recordset to something other than adOpenForwardOnly. If you are using a Command object, set the Source property of a recordset to the command object and change the cursor type in the recordset's Open() call.

STATUS

This behavior is by design.

Modification Type:MinorLast Reviewed:3/2/2005
Keywords:kbDatabase kberrmsg kbprb KB174225