Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function opens an existing database. CeOpenDatabase (RAPI)is a remote application interface, which enables an application running on a desktop computer to make function calls on a Windows CE–based device.
HANDLE CeOpenDatabase( PCEOID poid , LPWSTR lpszName , CEPROPID propid , DWORD dwFlags , HWND hwndNotify );
Parameters
Value | Description |
---|---|
CEDB_AUTOINCREMENT | Causes the current seek position to be automatically incremented with each call to the CeReadRecordPropsfunction. |
0 (ZERO) | Current seek position is not incremented with each call to CeReadRecordProps. |
Return Values
The handle to the open database indicates success. INVALID_HANDLE_VALUE indicates failure. To get extended error information within a RAPI program, call CeGetLastError. Possible values for CeGetLastErrorinclude the following:
Remarks
Use the CeCloseHandlefunction to close the handle returned by the CeOpenDatabasefunction.
Unlike many other traditional databases, opening and closing a database does not imply any transactioning. In other words, the database is not committed at the closing — it is committed after each individual call.
When writing applications for Windows CE versions 1.0 and 1.01, use the PegOpenDatabasefunction.
Requirements
Runs On | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | 1.01 and later | Rapi.h |
See Also
CeCloseHandle (RAPI), CeCreateDatabase (RAPI), CeGetLastError, CeReadRecordProps, CeSeekDatabase, CeSeekDatabase (RAPI)