Partager via

CeFindNextDatabaseEx (CEDB) (Windows Embedded CE 6.0)

  • Article

1/6/2010

This function retrieves the next database in an enumeration context.

This function does not work with EDB databases. For more information, see EDB Functions.

A RAPI version of this function exists named CeFindNextDatabaseEx (RAPI).

Syntax

CEOID CeFindNextDatabaseEx( 
  HANDLE hEnum,
  PCEGUID pceguid
);

Parameters

  • pceguid
    [out] Pointer to the CEGUID that contains the globally unique identifier of the next database.

Return Value

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.

Value Description

ERROR_KEY_DELETED

Indicates that a database was deleted during enumeration.

ERROR_NO_MORE_ITEMS

Indicates that there are no more databases to enumerate.

Remarks

To find all matching databases, this function is called in a loop until zero is returned. If a database is deleted during an enumeration, this function fails and returns error ERROR_KEY_DELETED. If this error occurs, you must restart the enumeration by calling CeFindFirstDatabaseEx. When enumeration is complete, the hEnum handle must be closed by calling the CloseHandle function.

Requirements

Header windbase.h
Library coredll.lib
Windows Embedded CE Windows CE 2.10 and later

See Also

Reference

CEDB Functions
CeFindFirstDatabaseEx (CEDB)
CloseHandle