CeDeleteRecord
This function deletes a record from a database. CeDeleteRecord is a RAPI that enables an application that is running on a desktop computer to make function calls on a Microsoft® Windows® CE–based device.
STDAPI_(BOOL) CeDeleteRecord(
HANDLE hDatabase,
CEOID oidRecord
);
Parameters
- hDatabase
[in] Handle to the database from which the record is to be deleted. The database must be open. Open a database by calling the CeOpenDatabase (RAPI) function. - oidRecord
[in] Object identifier of the record to be deleted, which is obtained from CeWriteRecordProps (RAPI).
Return Values
TRUE indicates success. FALSE indicates failure. To get extended error information within a RAPI program, call CeGetLastError. CeGetLastError may return ERROR_INVALID_PARAMETER if the handle or object identifier is invalid.
Remarks
If the CEDB_AUTOINCREMENT flag is not specified when the database is opened, and the record being deleted is the current record, the next read operation that uses the database handle will fail. If the CEDB_AUTOINCREMENT flag is specified, the system automatically moves the current seek pointer forward by one.
Note Earlier versions of Windows 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
Pocket PC Platforms: Pocket PC 2000 and later
OS Versions: Windows CE 3.0 and later
Header: rapi.h
Library: rapi.lib
See Also
Send feedback on this topic to the authors.
© 2005 Microsoft Corporation. All rights reserved.