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