IRAPISession::CeFindFirstDatabaseEx

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method opens an enumeration context for all databases in a mounted database volume on a remote Windows Embedded CE–based device.

Syntax

HANDLE CeFindFirstDatabaseEx(
  PCEGUID pceguid, 
  DWORD dwDbaseType 
);

Parameters

• pceguid
  [in] Pointer to the CEGUID that contains the globally unique identifier(GUID) of a mounted database volume. If pceguid is NULL or set to an invalid GUID, then all mounted database volumes are searched.

• dwDbaseType
  [in] Specifies the type identifier of the databases to enumerate. If this parameter is zero, all databases are enumerated in the volume. For Windows Embedded CE-based devices, a volume is the object store or a mounted database volume.

Return Values

A handle to an enumeration context indicates success. INVALID_HANDLE_VALUEindicates failure. To get extended error information, call IRAPISession::CeGetLastError and IRAPISession::CeRapiGetError. CeGetLastError may return ERROR_OUTOFMEMORY if no memory is available to allocate a database handle.

To find all the databases of the desired type, specify the enumeration context handle in multiple calls to the IRAPISession::CeFindNextDatabaseEx method.

Remarks

This function only returns the handle to an enumeration context. To begin enumerating databases, an application must call the IRAPISession::CeFindNextDatabaseExmethod. When an application is done with the handle to the enumeration context, an application uses IRAPISession::CeCloseHandle to release the resources associated with the enumeration context.

Requirements

See Also

Reference

IRAPISession
IRAPISession::CeCreateDatabaseEx
IRAPISession::CeFindNextDatabaseEx
IRAPISession::CeCloseHandle