CeFindFirstDatabase (RAPI)
This function opens an enumeration context to enable an application to enumerate all databases in the object store on a remote Microsoft® Windows® CE–based device.
Note This method has been deprecated. Use CeFindFirstDatabaseEx instead.
HANDLE CeFindFirstDatabase(
DWORD dwDbaseType
);
Parameters
- dwDbaseType
[in] The type identifier of the databases to enumerate. If this parameter is zero, all databases are enumerated. This value is application-defined and is set when the database is created using the CeCreateDatabase and CeCreateDatabaseEx methods.
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.
To get extended error information, call CeGetLastError and CeRapiGetError. 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
Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: Rapi.h
Library: Rapi.lib
See Also
Remote API Functions | CeFindFirstDatabase | CeFindNextDatabase | CeCloseHandle
Send Feedback on this topic to the authors