CeFindNextDatabaseEx (CEDB) (Compact 2013)

3/26/2014

This function retrieves the next database in an enumeration context.

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

See Also

Reference

CEDB Functions
CeFindFirstDatabaseEx (CEDB)
CloseHandle