Share via

CeFindNextDatabaseEx

  • Article

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.