CEDBASEINFOEX (EDB)

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains information about a database object. This structure is used when calling the CeCreateDatabaseWithProps (EDB), the CeSetDatabaseInfoEx (EDB), and the CeGetDBInformationByHandle (EDB) functions.

Syntax

typedef struct CEDBASEINFOEX {
  WORD wVersion;
  WORD wNumSortOrder;
  DWORD dwFlags;
  WCHAR szDbaseName[CEDB_MAXDBASENAMELEN]; 
  DWORD dwDbaseType;
  DWORD dwNumRecords;
  DWORD dwSize;
  FILETIME ftLastModified; 
  SORTORDERSPECEX rgSortSpecs[CEDB_MAXSORTORDER];
} CEDBASEINFOEX;

Members

• wVersion
  Version of this structure. Must be set to 2.

• wNumSortOrder
  Number of sort orders that can be active in the database. Up to 16 sort orders can be active at a time.

• dwFlags
  One or a combination of the following flags:

  • CEDB_VALIDDBFLAGS
  • CEDB_VALIDNAME
  • CEDB_NOCOMPRESS
  • CEDB_VALIDSORTSPEC
  • CEDB_VALIDTYPE

• szDbaseName
  Name of the database. The string can have up to CEDB_MAXDBASENAMELEN characters, including the terminating null character. This member must be set when used with the CeCreateDatabaseWithProps (EDB) function.

• dwDbaseType
  Type identifier for the database.

• dwNumRecords
  Number of records in the database.

• dwSize
  Not used by EDB.

• ftLastModified
  Not used by EDB.

• rgSortSpecs
  Array containing sort order descriptions. Only the first n array members are valid, where n is the value specified by the wNumSortOrder member.

Remarks

The following are the differences between this structure and the CEDB equivalent:

• In EDB, when no sort orders are specified for the CeCreateDatabaseWithProps (EDB) function or when CEDB_VALIDSORTSPEC is not specified, a default sort order is not assigned to the database. CEDB assigns a default sort order.
• EDB does not support the following dwFlags member values that CEDB supports:
  • CEDB_SYSTEMDB
  • CEDB_VALIDMODTIME
• EDB does not use the following fields that are used by CEDB:
  • dwSize
  • ftLastModified

Requirements

See Also

Reference

EDB Structures
CeCreateDatabaseWithProps (EDB)
CeSetDatabaseInfoEx (EDB)
CeGetDBInformationByHandle (EDB)