The CeCreateDatabase function creates a new database. A RAPI version of this function exists and is also called CeCreateDatabase.
CEOID CeCreateDatabase(LPWSTR lpszName, DWORD dwDbaseType, WORD wNumSortOrder, SORTORDERSPEC * rgSortSpecs);
Header file: | Winbase.h |
Component: | fsdbase |
Platforms: | H/PC |
Windows CE versions: | 1.01 and later |
If the function succeeds, the return value is the object identifier of the newly created database — not a handle to an open database. If the function fails, the return value is NULL. To get extended error information when within a CE program call GetLastError. If within a RAPI program, call CeGetLastError. GetLastError and CeGetLastError may return one of the following values:
Because sort orders increase the system resources needed to perform each insert and delete operation, keep the number of sort orders to a minimum. However, try not to specify too few sort orders. If you do, you can use the CeSetDatabaseInfo function to change the sort order later; however, this function is even more expensive in terms of system resources.
For more information, see Accessing Persistent Storage.
When writing applications for Windows CE version 1.0, use the PegCreateDatabase function.
CeDeleteDatabase, CeOidGetInfo, CeOpenDatabase, CeSetDatabaseInfo, SORTORDERSPEC