CeDeleteRecord (EDB)
A version of this page is also available for
4/8/2010
This function deletes a record from a database.
Syntax
BOOL CeDeleteRecord(
HANDLE hDatabase,
CEOID oidRecord
);
Parameters
- hDatabase
[in] Handle to the database from which to delete the record. The database is opened by using the CeOpenDatabaseInSession (EDB) function.
- oidRecord
[in] Object identifier of the record to delete. This object identifier must have been generated from EDB, not CEDB.
Return Value
TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError. The following table lists possible values.
| Return Value | Description |
|---|---|
ERROR_INVALID_HANDLE |
The hDatabase parameter is set to NULL or equal to INVALID_HANDLE_VALUE. |
ERROR_INVALID_PARAMETER |
The oidRecord parameter is set to NULL or invalid. |
ERROR_NOT_FOUND |
The record specified by oidRecord does not exist. |
ERROR_SHARING_VIOLATION |
Indicates a lock conflict. |
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 fails. If the CEDB_AUTOINCREMENT flag was specified, the system automatically moves the current seek pointer forward by one.
Requirements
| Header | windbase.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 5.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |