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