CEDBASEINFOEX (EDB)

  • Article

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

Header windbase.h
Library coredll.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

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