IRAPISession::CeDeleteDatabase (Windows Embedded CE 6.0)

  • Article

1/6/2010

This method removes a database from the object store on a remote Windows Embedded CE–based device.

Note

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

Syntax

BOOL CeDeleteDatabase(
  CEOID oidDbase 
);

Parameters

  • oidDbase
    [in] Object identifier of the database to be deleted.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call IRAPISession::CeGetLastError and IRAPISession::CeRapiGetError. Possible values for IRAPISession::CeGetLastError include the following:

ERROR_INVALID_PARAMETER

Note

A parameter was invalid.

ERROR_SHARING_VIOLATION

Note

Another thread has an open handle to the database.

Remarks

The IRAPISession::CeDeleteDatabase function deletes a database, including all records in the database.

Note

Earlier versions of Windows Embedded CE assigned object identifiers to objects in other file systems, such as the file allocation table (FAT) file system. These object identifiers were guaranteed to be unique within a volume, but not across multiple volumes. Effective with version 3.0, only objects in the object store have valid, unique object identifiers and the object store is the only volume that can return an object identifier.

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::CeOpenDatabase
IRAPISession::CeDeleteDatabaseEx