IRAPISession::CeFindFirstDatabaseEx
This method opens an enumeration context for all databases in a mounted database volume on a remote Microsoft® Windows® CE–based device.
HANDLE CeFindFirstDatabaseEx(
PCEGUID pceguid,
DWORD dwDbaseType
);
Parameters
- pceguid
[in] Pointer to the CEGUID that contains the globally unique identifier (GUID) of a mounted database volume. If pceguid is NULL or set to an invalid GUID, then all mounted database volumes are searched. - dwDbaseType
[in] Specifies the type identifier of the databases to enumerate. If this parameter is zero, all databases are enumerated in the volume. For Windows CE-based devices, a volume is the object store or a mounted database volume.
Return Values
A handle to an enumeration context indicates success. INVALID_HANDLE_VALUE **** indicates failure. 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.
To find all the databases of the desired type, specify the enumeration context handle in multiple calls to the IRAPISession::CeFindNextDatabaseEx method.
Remarks
This function only returns the handle to an enumeration context. To begin enumerating databases, an application must call the IRAPISession::CeFindNextDatabaseEx method. When an application is done with the handle to the enumeration context, an application uses IRAPISession::CeCloseHandle to release the resources associated with the enumeration context.
Requirements
OS Versions: Windows CE 5.01 and later.
Header: Rapi2.h.
Link Library: Ole32.lib, Rapiuuid.lib.
See Also
IRAPISession::IUnknown | IRAPISession::CeCreateDatabaseEx | IRAPISession::CeFindNextDatabaseEx | IRAPISession::CeCloseHandle
Send Feedback on this topic to the authors