IRAPISession::CeFindFirstDatabase (Windows Embedded CE 6.0)

1/6/2010

This method opens an enumeration context to enable an application to enumerate all databases in the object store on a remote Windows Embedded CE–based device.

Note

This method has been deprecated. Use IRAPISession::CeFindFirstDatabaseEx instead.

Syntax

HANDLE CeFindFirstDatabase(
  DWORD dwDbaseType 
);

Parameters

• dwDbaseType
  [in] The type identifier of the databases to enumerate. If this parameter is zero, all databases are enumerated. This value is application-defined and is set when the database is created using the IRAPISession::CeCreateDatabaseandIRAPISession::CeCreateDatabaseExmethods.

Return Value

A valid handle to an enumeration context indicates success. INVALID_HANDLE_VALUE indicates failure.

When passed a NULL value in the dwDbaseType parameter, IRAPISession::CeFindFirstDatabase returns a handle and sets the last error to ERROR_INVALID_PARAMETER.

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.

Remarks

This method only returns the handle to an enumeration context. To begin enumerating databases, an application must call the IRAPISession::CeFindNextDatabase method.

Use the IRAPISession::CeCloseHandle method to close a handle returned by the IRAPISession::CeFindFirstDatabase method.

Requirements

Header	rapi2.h
Library	ole32.lib, rapiuuid.lib
Windows Embedded CE	Windows Embedded CE 6.0 and later

See Also

Reference

IRAPISession
IRAPISession::CeCreateDatabase
IRAPISession::CeCreateDatabaseEx
IRAPISession::CeFindNextDatabase
IRAPISession::CeCloseHandle