CeFindNextDatabaseEx (CEDB) (Windows CE 5.0)

Send Feedback

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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.