IRAPISession::CeFindFirstDatabase
This method 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 IRAPISession::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 IRAPISession::CeCreateDatabase and IRAPISession::CeCreateDatabaseEx methods.
Return Values
A valid handle to an enumeration context indicates success. INVALID_HANDLE_VALUE indicates failure.
When passed a NULL value in the dwDbaseType parameter, IRAPISession::CeFindFirstDatabase returns a handle and sets the last error to ERROR_INVALID_PARAMETER.
To get extended error information, call IRAPISession::CeGetLastError and IRAPISession::CeRapiGetError. CeGetLastError may return ERROR_OUTOFMEMORY if no memory is available to allocate a database handle.
Remarks
This method only returns the handle to an enumeration context. To begin enumerating databases, an application must call the IRAPISession::CeFindNextDatabase method.
Use the IRAPISession::CeCloseHandle method to close a handle returned by the IRAPISession::CeFindFirstDatabase method.
Requirements
OS Versions: Windows CE 5.01 and later.
Header: Rapi2.h.
Link Library: Ole32.lib, Rapiuuid.lib.
See Also
IRAPISession::IUnknown | IRAPISession::CeCreateDatabase | IRAPISession::CeCreateDatabaseEx | IRAPISession::CeFindNextDatabase | IRAPISession::CeCloseHandle
Send Feedback on this topic to the authors