![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Section Contents
Applications that use this class will not work correctly on a version of EPOC earlier than ER5.
Not applicable.
d32dbms.h
edbms.lib
This class offers similar behaviour to the RDbIncremental class, i.e. it provides an interface which allows an application to perform long running operations while remaining responsive to events.
However, unlike RDbIncremental, this class is restricted to executing a DML (SQL data update) statement incrementally.
void Close();
Use this function to release the resources used by this incremental operation object. If the operation has not yet completed, it is abandoned and the database rolled back.
TInt Execute(RDbDatabase& aDatabase,const TDesC& aSql,TDbTextComparison aComparison=EDbCompareNormal);
Use this function to initiate the execution of a DML (SQL data update) statement on the database.
See also the Execute() member function of the RDbDatabase class.
RDbDatabase& aDatabase |
The database on which the DML (SQL data update) statement is to execute. |
const TDesC& aSql |
A reference to a descriptor containing the DML statement to be executed. |
TDbTextComparison aComparison |
This argument is only used in the execution of some SQL statements; see the Execute() member function of the RDbDatabase class. |
TInt |
or
or
|
To begin executing a DDL (SQL schema update) statement incrementally, use the RDbIncremental class.
TInt Next();
Use this function to perform the next step in the incremental execution of the DML (SQL data update) statement; it returns when the step is complete.
TInt |
or
or
|
void Next(TRequestStatus& aStatus);
Use this function to perform the next step in the incremental execution of the DML (SQL data update) statement; the function returns immediately and signals when the step is complete.
This function is most effectively used when the incremental operation is packaged as an active object.
TRequestStatus& aStatus |
The request status used to contain completion information for the operation. On completion, it contains:
or
or
|
TInt RowCount() const;
Use this function to return the number of rows currently affected by the execution of the DML (SQL data update) statement on the database.
Once execution of the DML statement is complete, the value returned is the final total number of rows affected.
TInt |
The current/final number of rows affected by the execution of the DML statement. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |