Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This function opens an enumeration context to enable an application to enumerate all databases in the object store.
CeFindFirstDatabase is a remote application interface (RAPI), which enables an application running on a desktop computer to make function calls on a Windows CE–based device.
HANDLECeFindFirstDatabase(DWORDdwDbaseType);
Parameters
- dwDbaseType
[in] Specifies the type identifier of the databases to enumerate. If this parameter is 0, all databases are enumerated.
Return Values
A handle to an enumeration context indicates success.
- INVALID_HANDLE_VALUE
Indicates failure.
When passed a NULL value in the dwDbaseType parameter, CeFindFirstDatabase returns a handle and sets the last error to ERROR_INVALID_PARAMETER.
Note To get extended error information within a RAPI program, call CeGetLastError. CeGetLastError may return ERROR_OUTOFMEMORY if no memory is available to allocate a database handle.
Remarks
This function only returns the handle to an enumeration context. To begin enumerating databases, an application must call the CeFindNextDatabase function.
Use the CeCloseHandle function to close a handle returned by the CeFindFirstDatabase function.
Requirements
OS Versions: Windows CE 1.01 and later.
Header: Rapi.h.
Link Library: Rapi.lib.
See Also
RAPI Functions | CeCloseHandle (RAPI) | CeFindNextDatabase (RAPI) | CeGetLastError (RAPI)
Send Feedback on this topic to the authors