Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains information about a database object. This structure is used by the CeSetDatabaseInfoand CeCreateDatabaseExfunctions.

Syntax

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

Members

dwFlags

This member is one or a combination of the following flags.

Flag Value Description

CEDB_VALIDNAME

0x0001

The szDbaseNamemember is valid and should be used.

CEDB_VALIDTYPE

0x0002

The dwDbaseTypemember is valid and should be used.

CEDB_VALIDSORTSPEC

0x0004

The rgSortSpecsmember is valid and should be used.

CEDB_VALIDMODTIME

0x0008

The ftLastModifiedmember is valid and should be used.

CEDB_VALIDDBFLAGS

0x0010

This flag should be used in combination with the following flag to set the compression state of the database.

CEDB_VALIDCREATE

0x0017

( CEDB_VALIDNAME| CEDB_VALIDTYPE| CEDB_VALIDSORTSPEC| CEDB_VALIDDBFLAGS)

CEDB_NOCOMPRESS

0x00010000

The database is not compressed. If this flag is used with CeSetDatabaseInfoEx, new or modified records in a compressed database are uncompressed. If this flag is used with CeCreateDatabaseEx, the database is not compressed.

By default, all databases are compressed. If you want 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 narray members are valid, where nis the value specified by the wNumSortOrdermember. If no sort orders are specified for CeCreateDatabaseExor when CEDB_VALIDSORTSPEC is not specified, then a default sort order is assigned to the database.

Remarks

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

Requirements

Header rapitypes.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also