This function retrieves the next database in an enumeration context. A remote application interface (RAPI) version of this function exists, and it is also named CeFindNextDatabaseEx.
At a Glance
| Header file: | Windbase.h |
| Windows CE versions: | 2.10 and later |
Syntax
CEOID CeFindNextDatabaseEx( HANDLE hEnum,PCEGUID pceguid );
Parameters
hEnum
[in] Handle returned from CeFindFirstDatabaseEx.
pceguid
[in] Pointer to the CEGUID that contains the globally unique identifier of a mounted 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. Possible values for GetLastError include the following:
ERROR_NO_MORE_ITEMS
There are no more databases to enumerate.
ERROR_KEY_DELETED
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.
See Also