CeFindNextDatabaseEx
This function retrieves the next database in an enumeration context.
A RAPI version of this function exists named CeFindNextDatabaseEx (RAPI).
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 database volume. This should be the same pointer that was passed to CeFindFirstDatabaseEx.
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 | CloseHandle | CREATE_SYSTEMGUID
Last updated on Friday, April 09, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.