CEDBASEINFO

This structure contains information about a database object. This structure is used by the CeSetDatabaseInfo and CeCreateDatabaseEx functions.

At a Glance

Header file: Windbase.h
Windows CE versions: 1.01 and later

Syntax

typedef struct _CEDBASEINFO {
DWORD
dwFlags;
WCHAR
szDbaseName[CEDB_MAXDBASENAMELEN];
DWORD
dwDbaseType;
WORD 
wNumRecords;
WORD 
wNumSortOrder;
DWORD
dwSize;
FILETIME
ftLastModified;
SORTORDERSPEC
rgSortSpecs[CEDB_MAXSORTORDER];
} CEDBASEINFO;

Members

dwFlags

The low-order word specifies the valid members of this structure. This member is one or a combination of the following flags:

Value Description
CEDB_VALIDMODTIME The ftLastModified member is valid and should be used.
CEDB_VALIDNAME The szDbaseName member is valid and should be used.
CEDB_VALIDTYPE The dwDbaseType member is valid and should be used.
CEDB_VALIDSORTSPEC The rgSortSpecs member is valid and should be used.
CEDB_VALIDDBFLAGS The low-order word of the dwFlags member is valid and should be used.

The high-order word specifies the associated database properties. This member is the following flag:

Value Description
CEDB_NOCOMPRESS The database is not compressed. If this flag is used with CeSetDatabaseInfoEx, a compressed database is uncompressed. If this flag is used with CeCreateDatabaseEx, the database is not compressed.
  To compress a database, CeSetDatabaseInfoEx or CeCreateDatabaseEx is called with CEDB_VALIDDBFLAGS set and the CEDB_NOCOMPRESS bit cleared. By default, all databases are compressed. If you are going to change the compression, it should be done at creation time.

szDbaseName

Null-terminated string that contains the name of the database. The string can have up to 32 characters, including the terminating null character. This member must be set when used for CeCreateDatabaseEx.

dwDbaseType

Specifies the type identifier for the database.

wNumRecords

Returns the number of records in the database.

wNumSortOrder

Number of sort orders active in the database. Up to four sort orders can be active at a time.

dwSize

Specifies, in bytes, the size of the database.

ftLastModified

Returns the last time this database was modified.

rgSortSpecs

Array containing the sort order descriptions. Only the first n array members are valid, where n is the value specified by the wNumSortOrder member. If no sort orders are specified for CeCreateDatabaseEx or when CEDB_VALIDSORTSPEC is not specified, then a default sort order is assigned to the database.

Remarks

For Windows CE versions 2.10 and later, dwFlags has additional meaning, but is still compatible with previous versions. The high-order word of dwFlags specifies additional database properties.

See Also

CeCreateDatabaseEx, CEOIDINFO, CeSetDatabaseInfoEx, HIWORD, LOWORD