This function deletes a record from a database. A remote application interface (RAPI) version of this function exists, and it is also named CeDeleteRecord.
At a Glance
| Header file: | Winbase.h |
| Windows CE versions: | 1.01 and later |
Syntax
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 function.
oidRecord
[in] Object identifier of the record to be deleted; this is obtained from CeOpenDatabase.
Return Values
TRUE indicates success. FALSE indicates failure. To get extended error information within a Windows CE program, call GetLastError. GetLastError and may return ERROR_INVALID_PARAMETER if the handle or object identifier is invalid.
Remarks
If the CEDB_AUTOINCREMENT flag was not specified when the database was 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 was specified, the system automatically moves the current seek pointer forward by one.
See Also