CeDeleteDatabase

This function removes a database from the object store. This function is obsolete. Applications should call CeDeleteDatabaseEx instead.

A remote application interface (RAPI) version of this function exists, and it also named CeDeleteDatabase.

BOOL CeDeleteDatabase(
CEOID oidDbase); 

Parameters

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

Return Values

TRUE indicates success. FALSE indicates failure. To get extended error information within a Windows CE–based program, call GetLastError. Possible values for GetLastError include the following:

  • ERROR_INVALID_PARAMETER
    A parameter was invalid.
  • ERROR_SHARING_VIOLATION
    Another thread has an open handle to the database.

Remarks

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

Note   Earlier versions (2.12 and prior) of Windows CE assigned OIDs to objects in other file systems, such as the FAT file system. These OIDs 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 OIDs and the object store is the only volume that can return an object identifier.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.01 and later Windbase.h Winbase.h Fsdbase.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CeDeleteDatabaseEx, CeCreateDatabaseEx, CeOidGetInfoEx, GetLastError

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.