Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function returns the OID of the next database that matches the enumeration criteria set up by calling the CeFindFirstDatabaseEx (EDB)function.

Syntax 

CEOID CeFindNextDatabaseEx(
  HANDLE 
hEnum,
  PCEGUID 
pGuid
);

Parameters

hEnum

[in] Handle to the enumeration context created by calling the CeFindFirstDatabaseExfunction.

pGuid

[out] On successful return, contains the GUID for the volume in which the found database resides. This parameter can be set to NULL.

Return Value

A valid CEOID indicates success. Zero indicates failure or a lack of additional databases. To get extended error information, call GetLastError. The following table shows possible values.

Return Value Description

ERROR_INVALID_HANDLE

The hEnum parameter is set to NULL or equal to INVALID_HANDLE_VALUE.

ERROR_KEY_DELETED

A database was deleted during enumeration.

ERROR_NO_MORE_ITEMS

There are no more items to enumerate.

Remarks

If there are no remaining databases left to enumerate, this function returns zero, and GetLastErrorreturns ERROR_NO_MORE_ITEMS.

As each volume is enumerated, this function takes a snapshot of the databases that are in the volume. As those databases are being enumerated, if one of them is deleted, this function returns zero, and GetLastErrorreturns ERROR_KEY_DELETED. If this error occurs, restart the enumeration with a call to CeFindFirstDatabaseEx.

When enumeration is complete, the hEnumhandle must be closed by calling the CloseHandlefunction.

The following are the differences between this function and the CEDB equivalent function:

  • The order of database enumeration in EDB is different from that in CEDB.

  • CEDB requires the CEGUID that is passed in to be the same as that used for CeFindFirstDatabaseEx. EDB ignores this value if it is set. EDB needs only the handle to identify the enumeration context.

Requirements

Header windbase.h
Library coredll.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also