CeFindNextDatabaseEx (CEDB) (Windows CE 5.0)
This function retrieves the next database in an enumeration context.
This function does not work with EDB databases. For more information on EDB, see EDB Functions.
A RAPI version of this function exists named CeFindNextDatabaseEx (RAPI).
CEOID CeFindNextDatabaseEx( HANDLE hEnum,PCEGUID pceguid);
Parameters
- hEnum
[in] Handle returned from CeFindFirstDatabaseEx (CEDB). - pceguid
[out] Pointer to the CEGUID that contains the globally unique identifier of the next database.
Return Values
A valid CEOID indicates success. Zero indicates failure or a lack of additional databases. Call GetLastError to get the extended error information. The following table lists possible values for GetLastError.
| Value | Description |
|---|---|
| ERROR_NO_MORE_ITEMS | Indicates that there are no more databases to enumerate. |
| ERROR_KEY_DELETED | Indicates that a database was deleted during enumeration. |
Remarks
To find all matching databases, CeFindNextDatabaseEx is called in a loop until 0 is returned. If a database is deleted during an enumeration, CeFindNextDatabaseEx fails and returns error ERROR_KEY_DELETED. If this error occurs, you must restart the enumeration with a call to CeFindFirstDatabaseEx. When enumeration is complete, the hEnum handle must be closed by calling the CloseHandle function.
Requirements
OS Versions: Windows CE 2.10 and later.
Header: Windbase.h.
Link Library: Coredll.lib.
See Also
CeFindFirstDatabaseEx (CEDB) | CloseHandle
Send Feedback on this topic to the authors