Location:
D32DBMS.H
Link against: edbms.lib
class RDbUpdate;
Provides an interface to allow incremental execution of a DML (SQL data update) statement.
This class offers similar behaviour to the RDbIncremental
class, in that it allows an application to perform long running operations while remaining responsive to events. However,
unlike that class, RDbUpdate is restricted to executing DML statements.
Defined in RDbUpdate
:
Close()
, Execute()
, Next()
, Next()
, RowCount()
Capability: | Security policy note: | For a secure shared database, the caller must satisfy: |
IMPORT_C TInt Execute(RDbDatabase &aDatabase, const TDesC &aSql, TDbTextComparison aComparison=EDbCompareNormal);
Initiates the incremental execution of a DML (SQL data update) statement on the database. This is similar to RDbDatabase::Execute()
.
Note that to begin executing a DDL (SQL schema update) statement incrementally, use the RDbIncremental
class.
|
|
IMPORT_C void Close();
Releases the resources used by this incremental operation object. If the operation is not yet complete, then the operation is abandoned and the database is rolled back to its state before the operation started.
IMPORT_C TInt Next();
Performs the next step in the incremental execution of the DML (SQL data update) statement synchronously. The function returns when the step is complete.
Note that if the incremental step fails, then the incremental object should be closed and the operation abandoned.
|
IMPORT_C void Next(TRequestStatus &aStatus);
Performs the next step in the incremental execution of the DML (SQL data update) statement asynchronously.
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.
Note that if the incremental step fails, then the incremental object should be closed, and the operation abandoned.
|
IMPORT_C TInt RowCount() const;
Returns 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.
|