CEDBASEINFOEX (CEDB) (Windows CE 5.0)
This structure contains information about a database object. This structure is used by the CeSetDatabaseInfoEx2 (CEDB) and CeCreateDatabaseEx2 (CEDB) functions.
typedef struct _CEDBASEINFOEX {WORD wVersion; DWORD dwFlags;WCHAR szDbaseName[CEDB_MAXDBASENAMELEN];DWORD dwDbaseType;DWORD dwNumRecords;WORD wNumSortOrder;DWORD dwSize;FILETIME ftLastModified;SORTORDERSPECEX rgSortSpecs[CEDB_MAXSORTORDER];} CEDBASEINFOEX;
Members
wVersion
Version of this structure. Applications must set wVersion to 1.dwFlags
This member may be set to one or a combination of values. The following table shows the possible values for dwFlags.Flag Description CEDB_VALIDMODTIME Indicates that the ftLastModified member is valid and should be used. CEDB_VALIDNAME Indicates that the szDbaseName member is valid and should be used. CEDB_VALIDTYPE Indicates that the dwDbaseType member is valid and should be used. CEDB_VALIDSORTSPEC Indicates that the rgSortSpecs member is valid and should be used. CEDB_VALIDDBFLAGS Indicates if the CEDB_NOCOMPRESS and CEDB_SYSTEMDB extended flags are being changed. The following table shows the possible extended flag values for dwFlags.
Extended flag Description CEDB_NOCOMPRESS Indicates that the database is not compressed. If this flag is used with CeSetDatabaseInfoEx2, new or modified records in a compressed database are uncompressed. If this flag is used with CeCreateDatabaseEx2, the database is not compressed. By default, all databases are compressed. If you are going to change the compression, it should be done at creation time.
CEDB_SYSTEMDB Indicates that the database is marked as a system database and cannot be deleted by an untrusted application. For more information on trusted applications and database security, see Database Security and Trusted APIs. 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 CeCreateDatabaseEx2.dwDbaseType
Type identifier for the database.dwNumRecords
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
Size of the database in bytes.ftLastModified
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 CeCreateDatabaseEx2 or when CEDB_VALIDSORTSPEC is not specified, then a default sort order is assigned to the database.
Remarks
CeSetDatabaseInfoEx2 and CeOidGetInfoEx2 (CEDB) can use all of the dwFlags flags. CeCreateDatabaseEx2 only makes use of the CEDB_VALIDDBFLAGS, CEDB_NOCOMPRESS, and CEDB_SYSTEMDB flags. Using other flags with CeCreateDatabaseEx2 will be ignored.
If you attempt to change the information for an existing database using CeSetDatabaseInfoEx2 (CEDB) and pass the CEDB_VALIDNAME flag in dwFlags, you will receive an error stating that there is an existing database with that name. If you do not want to change the database name, you should not set the CEDB_VALIDNAME flag. Only the flags for the parameters that are changing should be set. For parameters that are not changing, you should not set the corresponding CEDB_VALID* flag.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Windbase.h.
See Also
CeCreateDatabaseEx2 (CEDB) | CeSetDatabaseInfoEx2 (CEDB) | CeSetDatabaseInfoEx2 (CEDB) | CEOIDINFOEX (CEDB) | CeOidGetInfoEx2 (CEDB) | CeGetDBInformationByHandle (CEDB) | SORTORDERSPECEX (CEDB) | Database Security | Trusted APIs
Send Feedback on this topic to the authors