EPOC   SDK Home Glossary Indexes Previous Next Up

RDbIncremental class


Contents


RDbIncremental class — Database incremental operations

Section Contents

The following members of this class are new in EPOC Release 5. They offer new functionality for:

See RDbIncremental for the pre-ER5 documentation for this class.


Starting incremental operations


UpdateStats() — Begin updating database statistics

TInt UpdateStats(RDbDatabase& aDatabase,TInt& aStep);

Compatibility

Applications that call this member function will not work correctly on a version of EPOC earlier than ER5.

Description

Use this function to initiate the operation of calculating and updating database statistics.

See also the UpdateStats() member function of the RDbDatabase class.

Arguments

RDbDatabase& aDatabase

The database whose statistics are to be updated.

TInt& aStep

On return, contains the initial step count for the incremental operation. This value should be passed in to subsequent calls to Next() to continue the operation.

Return value

TInt

KErrNone or one of the system error codes; see system error codes.


Compact() — Begin database compaction

TInt Compact(RDbDatabase& aDatabase,TInt& aStep);

Compatibility

Applications that call this member function will not work correctly on a version of EPOC earlier than ER5.

Description

Use this function to initiate the operation for compacting a database.

See also the Compact() member function of the RDbDatabase class.

Arguments

RDbDatabase& aDatabase

The database to compact.

TInt& aStep

On return, contains the initial step count for the incremental operation. This value should be passed in to subsequent calls to Next()to continue the operation.

Return value

TInt

KErrNone or one of the system error codes; see system error codes.


Execute() — Begin executing a DDL (SQL schema update) statement

TInt Execute(RDbDatabase& aDatabase,const TDesC& aSql,TInt& aStep);

TInt Execute(RDbDatabase& aDatabase,const TDesC& aSql,TDbTextComparison aComparison,TInt& aStep);

Compatibility

Applications that call this member function will not work correctly on a version of EPOC earlier than ER5.

Description

Use these functions to initiate the execution of a DDL (SQL schema update) statement on the database.

See also the Execute() member function of the RDbDatabase class.

Arguments

RDbDatabase& aDatabase

The database on which the DDL (SQL schema update) statement is to execute.

const TDesC& aSql

A reference to a descriptor containing the DDL SQL statement to be executed on the database.

TDbTextComparison aComparison

This argument is only used in the execution of some SQL statements; see the Execute() member function of the RDbDatabase class.

TInt& aStep

On return, contains the initial step count for the incremental operation. This value should be passed in to subsequent calls to Next()to continue the operation.

Return value

TInt

KErrNone or one of the system error codes; see system error codes.

Notes

To begin executing a DML (SQL data update) statement incrementally, use the RDbUpdate class.

EPOC       SDK Home Glossary Indexes Previous Next Up