EDB的简单使用

EDB是从Windows Mobile 5.0后出现的，提供了比CEDB更好的性能。

要使用EDB，首先就是mount

BOOL CeMountDBVol(

  PCEGUID pceguid,

  LPWSTR lpszDBVol,

  DWORD dwFlags

);

它的第一个参数是一个CEGUID类型的指针，也是一种唯一标识符，一般在开始使用前先用CREATE_SYSTEMGUID来将其清0。第二个参数就是数据库卷的卷名，第三个参数就标志，这个标志位的意义与CreateFile的非常类似，其实EDB也是一种特殊的文件。也可以用CeMountDBVolEx函数来挂载卷。

将卷挂上之后，就可以使用CeCreateDatabaseWithProps函数来创建数据库。它的声明如下：

CEOID CeCreateDatabaseWithProps(

  PCEGUID pGuid,

  CEDBASEINFOEX* pInfo,

  DWORD cProps,

  CEPROPSPEC* prgProps

);

第一个参数就是CeMountDBVol的第一个参数传回的CEGUID，第二个参数是重点，里面包含了要创建的数据库的结构，即每个属性列的类型等。第三个参数指示了第四个参数的个数。第四个参数是好像是指定属性列的一些其它信息用的(这个也不清楚)。

CEDBASEINFOEX的定义如下：

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;

 

例如这段代码就创建了一个有两个属性列的数据库，第一个属性是名字，第二个属性是年龄。

CEDBASEINFOEX       dbInfo = {0};

       dbInfo.wVersion = CEDBASEINFOEX_VERSION;

       dbInfo.dwFlags = CEDB_VALIDDBFLAGS | CEDB_VALIDNAME | CEDB_VALIDSORTSPEC;

       dbInfo.wNumSortOrder = 1;

       _tcscpy(dbInfo.szDbaseName, szDbname);

 

       dbInfo.rgSortSpecs[0].wVersion = SORTORDERSPECEX_VERSION;

       dbInfo.rgSortSpecs[0].wNumProps = 1;

       dbInfo.rgSortSpecs[0].wKeyFlags = 0;

       dbInfo.rgSortSpecs[0].rgPropID[0] = PROP_NAME;

       dbInfo.rgSortSpecs[0].rgdwFlags[0] = CEDB_SORT_UNKNOWNFIRST;

 

       dbInfo.rgSortSpecs[1].wVersion = SORTORDERSPECEX_VERSION;

       dbInfo.rgSortSpecs[1].wNumProps = 1;

       dbInfo.rgSortSpecs[1].wKeyFlags = 0;

       dbInfo.rgSortSpecs[1].rgPropID[0] = PROP_AGE;

       dbInfo.rgSortSpecs[1].rgdwFlags[0] = CEDB_SORT_UNKNOWNFIRST;

       CeCreateDatabaseWithProps(&g_VolGuid, &dbInfo, 0, NULL);

因为rgSortSpecs数组被定义为16，所以EDB的属性列最多也就是16。

当创建好数据库之后，就可以打开数据库了，然后才能进行读写数据库。

要打开数据库，先用CeCreateSession创建一个会话，然后用CeOpenDatabaseInSession来得到一个数据库句柄。

写数据库是通过CeWriteRecordProps函数来实现的。

CeWriteRecordProps的定义如下：

CEOID CeWriteRecordProps(

  HANDLE hDatabase,

  CEOID oidRecord,

  WORD cPropID,

  CEPROPVAL* prgPropVal

);

若oidRecord为0，则新添加的记录直接追加到最后。最后一个参数是用来填充属性的数据。

要写数据库，示例代码如下：

prop[0].propid = PROP_NAME;

       prop[0].val.lpwstr = _T("某某");

       prop[0].wFlags = 0;

 

       prop[1].propid = PROP_AGE;

       prop[1].val.uiVal = 25;

       prop[1].wFlags = 0;

 

       CeWriteRecordProps(hdb, 0, 2, prop);

 

要想读数据库，只要用CeReadRecordPropsEx函数即可。

它的定义如下：

CEOID CeReadRecordPropsEx(

  HANDLE hDatabase,

  DWORD dwFlags,

  LPWORD lpcPropID,

  CEPROPID* prgPropID,

  LPBYTE lplpBuffer,

  LPDWORD lpcbBuffer,

  HANDLE hHeap

);

第三个参数是返回属性列的个数，第四个参数即是用来指定要接收哪些属性列的数据，如果为NULL，则接收所有。第五个参数即是返回的数据。如果第二个参数指定为：CEDB_ALLOWREALLOC的话，则在不必要使用lplpBuffer之前申请空间。最后一个参数就是要使用的堆的句柄。

再操作完之后，要使用CloseHandle关闭数据库的句柄，并且再最后CeUnmountDBVol卸载数据库。

 

下面贴上简单的代码

1. #define EDB
3. #include <Windows.h>
4. #include <windbase.h>
6. #ifndef EDB 
7. #include <windbase_edb.h> 
8. #endif 
10. #define MAKEPROP(n,t)    ((n<<16)|CEVT_##t)
12. #define     PROP_NAME   MAKEPROP(10, LPWSTR)
13. #define     PROP_AGE    MAKEPROP(10, UI2)
15. CEGUID  g_VolGuid;
16. LPTSTR  szDbname = _T("MyMsgDb");
17. LPTSTR  szDbVol = _T("Test.edb");
18. HANDLE  g_hSession;
20. BOOL    CreateMyDB();
21. BOOL    WriteMyDB(HANDLE hdb);
22. BOOL    OpenDB(HANDLE *phDB);
23. BOOL    ReadMyDB(HANDLE hDb);
25. int WINAPI WinMain(HINSTANCE hInstance,
26.                    HINSTANCE hPrevInstance,
27.                    LPTSTR    lpCmdLine,
28.                    int       nCmdShow)
29. {
30.     if (FALSE == CreateMyDB())
31.         return  FALSE;
32.     
33.     HANDLE  hDb;
34.     OpenDB(&hDb);
36.     //CeSeekDatabaseEx(hDb, CEDB_SEEK_BEGINNING, 0, 0, 0);
38.     WriteMyDB(hDb);
39.     CloseHandle(hDb);
41.     CEOID   DBoid = 0;
42.     hDb = CeOpenDatabaseInSession( g_hSession, 
43.         &g_VolGuid, 
44.         &DBoid, 
45.         szDbname, 
46.         NULL, 
47.         0,
48.         NULL);
49.     CeSeekDatabaseEx(hDb, CEDB_SEEK_BEGINNING, 0, 0, 0);
50.     ReadMyDB(hDb);
52.     CloseHandle(hDb);
53.     return  0;
54. }
56. BOOL CreateMyDB()
57. {
58.     CREATE_SYSTEMGUID(&g_VolGuid);
60.     
61.     CEDBASEINFOEX   dbInfo = {0};
62.     dbInfo.wVersion = CEDBASEINFOEX_VERSION;
63.     dbInfo.dwFlags = CEDB_VALIDDBFLAGS | CEDB_VALIDNAME | CEDB_VALIDSORTSPEC;
64.     dbInfo.wNumSortOrder = 1;
65.     _tcscpy(dbInfo.szDbaseName, szDbname);
67.     dbInfo.rgSortSpecs[0].wVersion = SORTORDERSPECEX_VERSION;
68.     dbInfo.rgSortSpecs[0].wNumProps = 1;
69.     dbInfo.rgSortSpecs[0].wKeyFlags = 0;
70.     dbInfo.rgSortSpecs[0].rgPropID[0] = PROP_NAME;
71.     dbInfo.rgSortSpecs[0].rgdwFlags[0] = CEDB_SORT_UNKNOWNFIRST;
73.     dbInfo.rgSortSpecs[1].wVersion = SORTORDERSPECEX_VERSION;
74.     dbInfo.rgSortSpecs[1].wNumProps = 1;
75.     dbInfo.rgSortSpecs[1].wKeyFlags = 0;
76.     dbInfo.rgSortSpecs[1].rgPropID[0] = PROP_AGE;
77.     dbInfo.rgSortSpecs[1].rgdwFlags[0] = CEDB_SORT_UNKNOWNFIRST;
79.     if (!CeMountDBVol(&g_VolGuid, szDbVol, CREATE_ALWAYS | EDB_MOUNT_FLAG))
80.     {
81.         DWORD   dd = GetLastError();
82.         return  FALSE;
83.     }
85.     CEOID   DBOid = 0;
86.     if(NULL == (DBOid = CeCreateDatabaseWithProps(&g_VolGuid, &dbInfo, 0, NULL)))
87.     {
88.         DWORD   dd = GetLastError();
89.         return  FALSE;
90.     }
91.     return  TRUE;
92. }
94. BOOL WriteMyDB(HANDLE hdb)
95. {
96.     CEPROPVAL prop[2] = {0};
97.     prop[0].propid = PROP_NAME;
98.     prop[0].val.lpwstr = _T("猛哥");
99.     prop[0].wFlags = 0;
101.     prop[1].propid = PROP_AGE;
102.     prop[1].val.uiVal = 24;
103.     prop[1].wFlags = 0;
105.     CeWriteRecordProps(hdb, 0, 2, prop);
107.     prop[0].propid = PROP_NAME;
108.     prop[0].val.lpwstr = _T("某某");
109.     prop[0].wFlags = 0;
111.     prop[1].propid = PROP_AGE;
112.     prop[1].val.uiVal = 25;
113.     prop[1].wFlags = 0;
115.     CeWriteRecordProps(hdb, 0, 2, prop);
117.     CeFlushDBVol(&g_VolGuid);
119.     return  TRUE;
120. }
122. BOOL OpenDB(HANDLE *phDB)
123. {
124.     CEOID DBOid=0;
126.     g_hSession = CeCreateSession(&g_VolGuid);
128.     *phDB = CeOpenDatabaseInSession( g_hSession, 
129.         &g_VolGuid, 
130.         &DBOid, 
131.         szDbname, 
132.         NULL, 
133.         CEDB_AUTOINCREMENT,
134.         NULL);
136.     return  TRUE;
137. }
139. BOOL ReadMyDB(HANDLE hDb)
140. {
141.     CEOID oidRecord = 0;
142.     WORD    wNumProps = 0;
143.     CEPROPVAL *pRecord = NULL;
144.     DWORD   dwBufSize = 0;
146.     while (oidRecord = CeReadRecordPropsEx(hDb, CEDB_ALLOWREALLOC, &wNumProps, NULL, (LPBYTE *)&pRecord, &dwBufSize, NULL))
147.     {
148.         for (int i = 0; i < wNumProps; i++) {
149.             switch(pRecord[i].propid) 
150.             {
151.             case    PROP_NAME:
152.                 break;
154.             case    PROP_ID:
155.                 break;
156.             }
157.     }
159.     return  TRUE;
160. }

 

(刚学edb，可能会有好多错误，希望大家提出批评指正)