CCeDBDatabase

This class encapsulates a database in the object store. A Windows CE database is not a full-function database, but a general-purpose structured collection of data.

Each Windows CE object store database has a unique name. You can also assign an application-defined type identifier to a database. Use this identifier to group similar databases.

A Windows CE database can have up to four sort properties that specify how the records are ordered.

If you specify a sort property when you open a database, and there are records in the database that do not contain the property on which the database is being sorted, those records are placed last in the sort order. If the sort property was defined with the flag Sort_UnknownFirst, they are placed before the sorted records, instead.

At a Glance

Header file: Wcedb.h
Platforms: H/PC 2.0, Palm-size PC, H/PC Pro
Windows CE versions: 2.0 and later

Remarks

A Windows CE database only supports one level of hierarchy. Records cannot be shared by multiple databases. Every record has a unique object identifier, and is present in exactly one database.

In Windows CE 2.0, a database can have up to CEDB_MAXSORTORDER sort properties, which are used to determine the order in which records are arranged. In order to do a seek operation on a property value, that property must be one of the properties specified in the database's sort order.

Two sort properties in the same database cannot have the same application-defined identifier.

If no sort order is specified when a database is opened, the order in which the records are sorted is undefined.

In MFC for Windows CE 2.10, CEDB_MAXSORTORDER is defined as 4.

See Also

CCeDBRecord, CCeDBProp, Unique MFC Classes for Windows CE